Aminet 43/Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso/Wildfire/Doc/Wildfire.guide

Amigaguide Document | 1977-12-31 | 303KB | 7,623 lines

@database Wildfire
@$VER: Wildfire.guide V3.97
@node Main "Wildfire Documentation"
#################################################################
#                                                               #
#       Wildfire - ein Animations-System f
r den Amiga          #
#                                                               #
#            Copyright
 1995-1997 WK-Artworks                  #
#                  All rights reserved                          #
#            Unauthorized Duplication Prohibited                #
#---------------------------------------------------------------#
#                                                               #
#                        Dokumentation                          #
#                                                               #
#################################################################
    @{"  1. Einf
hrung            " link introduction   }   @{" 12. Autoren               " link Authors        }
    @{"  2. System Anforderungen  " link requirements   }   @{" 13. Copyright             " link Copyright      }
    @{"  3. Installation          " link installation   }   @{" 14. Entwickler-Infos      " link Developer      }
    @{"  4. Benutzung             " link Usage          }   @{" 15. FAQ                   " link FAQ            }
    @{"  5. Technische Infos      " link Technical      }

    @{"  6. Haupt Dokumentation   " link MainWindow     }   @{" 16. Bestellung            " link Order          }
    @{"  7. Vorhandene Effekte    " link PCAddWindow    }
    @{"  8. PowerPlugs!           " link PowerPlugs!    }   @{" 17. Tutorials             " link Tutorials      }

    @{"  9. Der YAFA Abspieler    " link yp.guide/MAIN  }   @{" 18. Wildfire Demos        " link Demos          }

    @{" 10. ARexx                 " link ARexx          }   @{" 19. Bonus Programs        " link Bonus          }
    @{" 11. Bekannte Fehler       " link Bugs           }

Dokumentations-Autoren : Andreas K
ssner, Andreas Maschke
Letzte
nderungen      : Sunday 21-Sep-97
Version                : 4.07
Wildfire-Unterst
tzung : [e-mail]
                         http://www.oberland.com/amiga/wildfire/
@endnode
@remark TODO:
@remark  -Tutorials
@remark  -Developer-kit
@node Introduction
---------------------------------------------------------------------
           Wildfire - where dreams become virtuality
           Ein Spezial Effektprogram und vieles mehr
---------------------------------------------------------------------
@{ub}
Wildfire ist nicht nur ein weiteres neues Bildbearbeitungsprogramm - nein,
es ist ein professionelles Animations-Programm, welches wirklich neue
Konzepte bietet.
Zum Beispiel kann man mit WF Aminationen in verschiedenen Formaten
erstellen und bearbeiten, zeitabh
ngige Spezialeffekte erstellen und
Animations-shows - die aus mehreren aneinandergereihten Anims bestehen -
mit Spezialeffekten und Synchronisierter Musik kreeiren.
Da die normalen Animationsformate auf dem Amiga zu viele Beschr
nkungen
oder Schw
chen haben, versuchten wir ein besseres Format zu entwickeln:
YAFA Zum Beispiel unterst
tzt dieses Format viele Packmethoden und
echtzeit-zooming.
Eine der bemerkenswertesten Eigenschaften von Wildfire ist es, da
 es f
den Anwender keinen Unterschied macht, ob er eine Animation bearbeitet
oder sich lediglich mit einem Einzelbild besch
ftigt.  Ein Einzelbild ist
ein Spezialfall von einer Animation!
Im Gegensatz zu den normalen Bildbearbeitungsprogrammen kann man
Variablen-Kurven anstatt von festen Zahlen als Effektparameter benutzen.
Dies macht die Generierung von Zeitabh
ngigen Spezial-Effeten m
glich.
Alle Effekte k
nnen uneingeschr
nkt kombiniert werden.  Die Ausgabe aller
Effekte kann in bis zu 8 tempor
re Puffer und in 4 3D-Puffer umgeleitet
werden.  Diese Puffer k
nnen frei miteinander kombiniert werden.  Somit
ist es m
glich, Bilder mit wenigen Handgriffen zu `programmieren`!!!
Eigenschaften:
Volle PowerPC und CyberGraphX-Unterst
tzung
Schneller und komfortabler Konverter:
    Eingabe:  YAFA, ANIM5/7/8, mpeg, Bild-Sequencen
    Ausgabe:  YAFA, ANIM5/7/8, Bild-Sequencen
Vorschau f
r fast alle Effekte (auch in ECHTZEIT m
glich!!!)
Projekt-Editor, in dem das Erstellen von gro
en Projekten einfach mit der
Maus erledigt werden kann
Effekt-Generator mit zeitabh
ngigen Variablen unter der Zuhilfenahme von
`Envelopes`
Eine sehr gro
e Auswahl an Spezial-Effekten (
ber 80!)
Einige wirklich einzigartige Effekte
3D-Engine mit mehreren Lichtquellen und Phong-shading
berlagerung von 3D-Effekten (PowerPlugs!)
berlagerung von Lightwave-Objeten und Bildern im 3-dimensionalen Raum
PlugIns werden erst geladen, wenn sie ben
tigt werden!
Envelope-Editor
Timecodes-Editor
Transition-Maker f
r die einfache Erstellung von Umblendungen zwischen
Bildern oder Animationen
Einfach zu bedienendes Player-Interface
Filmstrips um das Timing von gro
en Projeten zu vereinfachen
AnimInfo-Funktion die Gr
en-Profile und andere Daten anzeigt
Fontsensitives GUI ohne MUI
Interne Gadget-Toolbox die mathematische Ausdr
cke anstatt von einfachen
Zahlen verarbeiten kann
Taschenrechner, der den Export von Benutzerdefinierten Symbolen in alle
Eingabefelder des Programs erlaubt
Drag&Go
(drag.gadget 1.0 beta Copyright
 1997 J
rg Kollmann, siehe Bonus
directory!)
ARexx-port mit
ber 400 Kommandos
Macros, Eigene Fenster, ...
Import von Bildern aus anderen Programmen
und vieles mehr
@endnode
@node Requirements
  @{b}System Vorraussetzungen@{ub}
  @{u}Hardware@{uu}
    -Prozessor:    68020 oder besser
    -Grafik   :    AGA oder Grafikkarte
    -Speicher :    4 MB
    Empfohlen :    Schneller Prozessor
                   Viel Speicher wenn gro
e Bilder
                   mit High End 3D Effekten bearbeitet werden sollen
  @{u}Software@{uu}
    -Operation System V39 (3.0)
    -XPK Kompressions System (xpkFAST empfohlen)
  Das Program wurde erfolgreich auf folgenden Rechner mit verschiedenen
  Hard-Disk und Speicherkonfigurationen getestet:
  A1200 (030, 060), A4000 (030, 040, 060, 060+PPC 404e)
@endnode
@node Order
Wo kann man Wildfire kaufen?
Wildfire wird durch Oberland Computer vertrieben.
Wenn Sie n
here Informationen erhalten wollen, schreiben Sie
eine Email an [e-mail] oder schreiben Sie direkt an Oberland
Computer:
Oberland Computer
In der Schneithohl 5
61476 Kronberg
Germany
Tel. ++49-(0)6173-6080
email: [e-mail]
Wildfire wird auf CD erscheinen mit einigen Beispielen u.s.w.
Registrierte Anwender der Shareware Version erhalten ein spezielles
Update-Angebot, sobald die Version 5 von Wildfire ver
ffentlicht wird.
Es wird zwei verschiedene Versionen geben:
- WF 5.0 Amiga native
- WF 5.0 Amiga PPC
Wahrscheinlich werden demn
chst auch folgende Versionen erh
ltlich sein:
- WF 5.0 Movieshop/Draco
- WF p.OS
@endnode
@node Installation
  @{b}Installation@{ub}
Installieren Sie Wildfire einfach mittels des mitgelieferten Scripts.
Falls wider Erwarten Probleme auftreten sollten oder Sie es lieber
per Hand installieren m
chten, auch dies ist m
glich:
Kopieren Sie die Wildfire Directory aus der Ihren Anspr
chen gerechten
Directory (Deutsch/Englisch, FPU/NO-FPU) auf Ihre Festplatte.
Legen Sie ein "Assign WF: " auf diese Directory.
Danach Kopieren Sie das File "envarc/Wildfire.config" nach "Envarc:"
In beiden F
llen k
nnen Sie nach dem Start von Wildfire Thumbnails
(kleine Vorschaubilder, die im Prozessor, wenn Sie Effekte ausw
hlen,
angezeigt werden) erzeugen, die f
r Ihre Bidschirmtiefe angepa
t sind.
Mit Wildfire werden Thumbnails in 24 Bit mitgeliefert, die automatisch
heruntergerechnet werden. Falls Ihnen das zu langwierig ist (starten Sie
einfach den Prozessor und klicken Sie auf `ADD` und w
hlen Sie mit den
Cursortasten einige Effekte aus, sie werden die Geschwindigkeit der
Vorschaubilder erkennen) k
nnen Sie jederzeit f
r die von Ihnen
hlte Bildschirmtiefe, auf der Wildfire l
uft, Thumbnails erzeugen.
Dazu dr
cken Sie die Funktionstaste F10 und w
hlen das Makro:
wf:Macros/createExamples.rexx
aus und folgen den Anweisungen.
Das selbe gilt auch f
r die Transition-Beispiele, dies sind kleine Filme,
die im Transition-Maker gespielt werden und Ihn einen Eindruck von dem
ausgew
hlten Effekt geben. Diese k
nnen Sie mit dem gleichen Script
erstellen, jedoch kann dies auf langsamen Rechnern mehrere Stunden dauern!
  @{b}File-Hierarchie@{ub}
    Wildfire
    +---system               -Private Files
    |   +---plugIns            *PlugIns-Hauptdirectory
    |   |   +---operators        Operatoren f
r den Processor
    |   |   +---general          Generelle PlugIns
    |   |   +---system           PlugIn-Voreinstellungen
    |   |   \---savers           SPeicher-und Lademodule
    |   +---images             *Ikons f
r den Ikon-Manager
    |   +---filmstrips         *Filmstrips f
r den Transition-Maker
    |   +---thumbnails         *Previews f
r das Operators-Fenster
    |   \---help               *einige Textfiles
    +---alpha                -Alpha-Bilder
    +---trash                -Tempor
re Files
    +---expressions          -Expressions und Symbols f
r den Taschenrechner
    +---profiles             -Gr
en Profile f
r Animationen
    +---YAFAOptions          -YAFA-Compressor-Einstellungen
    +---annotations          -Annotationen und Text-Files
    +---convolutions         -Matrix-Einstellunegn f
r das Convolve-PlugIn
    +---doc                  -Dokumentation und Online-Help-Files
    +---envelopes            -Envelopes f
r den Processor
    +---filmstrips           -Filmstrips
    +---images               -Bilder
    +---macros               -ARexx-Macros
    +---processes            -Processor-Skripts
    +---projects             -Video-Projekte
    +---sessions             -Konverter-Sessions
    +---tools                -weitere Tools
    +---variables            -Variablen f
r den Processor
    \---windows              -Eigene Fenster
@endnode
@node Bugs
  @{b}Bekannte Fehler@{ub}
   -Falls der Speicher knapp wird, kann es unter Umst
    zu Abst
rzen kommen
   -Falls Wildfire nicht startet, probieren Sie in der
    Shell   `WF -noPrefs`  einzugeben und schon wird Wildfire
    auf dem Standard-Publicscreen (meist die Workbench) gestartet
@endnode
@node Authors
 Wildfire-Unterst
tzung:
 EMail:        [e-mail]
  @{b}Wildfire, Teile des YAFA-Konzepts, Animationen@{ub}
  Andreas Maschke  (WK-Artworks)
  @{b}YAFA-Abspieler, YAFA-Konzept, Ideen@{ub}
  Michael Henke  (Smack/Infect)
  EMail: [e-mail]
  @{b}Ideen, Dokumentation, Moralische Unterst
tzung,
      Beta-Tests, Anwender Support:@{ub}
  Andreas K
ssner
  Marrinksweg 5
  48531 Nordhorn
  Germany
  EMail: [e-mail] (Wildfire-Support)
  Telefon: ++49 (0)5921/330420  (18 - 20 Uhr Werktags)
@endnode
@node Copyright
@{b}Copyright@{ub}
Wildfire ist Copyright (c) 1996-97 WK-Artworks (Andreas Maschke).
All rights reserved.
Kommerzielle Benutzung ist untersagt. Falls Sie Wildfire f
r kommerzielle
Zwecke verwenden wollen, m
ssen Sie vorher eine schriftliche Erlaubnis
der @{"Autoren" link Authors} einholen!
@{b}Haftungsausschlu
@{ub}
Wir leisten keinerlei Garantien, weder audr
cklich noch stillschweigend,
 dieses Program und die enthaltene Anleitung f
r einen speziellen
Zweck geeignet ist.
Unter keinen Umst
nden haften wir f
r etwaige auftretende Sch
Folgesch
den, auftretende Verluste oder entgangene Gewinne, die
im direkten, indirekten oder zuf
lligen Zusammenhang mit unserer Software
stehen.
Wir behalten uns die Richtigkeit der im Handbuch oder in der Online-Hilfe
beschriebenen Funktionen und der im Programm enthaltenen Funktionen vor.
Wir behalten uns das Recht vor, Ver
nderungen am Programm und der
Dokumentation vorzunehmen, ohne in irgendeiner Weise darauf
hinweisen zu m
ssen.
@endnode
@node Usage
@{b}Benutzung@{ub}
Das Program kann diret von der Workbench oder von der Shell
(wf [optionen]) gestartet werden.
Die meisten Operationen k
nnen mit der Maus oder mit der Tastatur
gesteuert werden.
Es existieren keine PullDown-Men
s, da die AGA-Hardware zu langsam ist,
um Men
s auf einem tieferen Bildschirm (z.B. 32 Farben) zu berechnen.
erdem hat Wildfire zu viele Funktionen (
ber 120 Fenster mit
ber 1600
Gadgets!) um sie in Men
s ohne eine komplexe Hierarchie unterzubringen.
@{b}Optionen@{ub}
 -h                : nur Anzeige von Informationen (hilfe)
 -debug            : Debug-Ausgabe wird angeschaltet
 -noPrefs          : Konfiguration wird ignoriert und das Program
                     wird auf dem Workbench-Screen als Public Screen
                     gestartet (z.B. f
r GFX-Karten Anwender, falls
                     Probleme auftauchen sollten)
 -noPPC            : PPC-Code wird NICHT verwendet
 -noCyberGraphX    : CyberGraphX-Code wird NICHT verwendet
 -screenModeReq    :
ffnen eines Bildschirmmode-Requesters beim starten
 -screenMode <id>  :
ffnet das Program auf einem eigenen Screen mit
                     dem angegebenen Mode. (vergessen Sie die "0x" nicht,
                     wenn die Hex-Zahlen angegeben werden.)
 -stWhite          : Verwendung eines wei
en Hintergrundes f
r das
                     StoryBoard (z.B. f
r Bildschirmfotos)
 -root <drawer>    : Angabe der Hauptdirectory
 -prefsfile <file> : laden der Einstellungen von dem <file>
@{b}ToolTypes@{ub}
 DEBUG
 NOPREFS
 NOPPC
 NOCYBERGRAPHX
 SCREENMODEREQ
 SCREENMODE=<id>
 STWHITE
 ROOT=<drawer>
 PREFSFILE=<file>
@endnode
@remark /*************************************************************/
@remark /*
@remark                                 Main
@remark */
@remark /*************************************************************/
@node MainWindow
@{b}Das Haupt-Fenster (Main)@{ub}
Nach der Initialisierung
ffnet Wildfire das Hauptfenster auf einem
Bildschirm Ihrer Wahl.
Alle Haupt-Programmteile k
nnen von diesem Fenster aus erreicht werden.
Da Wildfire sehr viele Funktionen und auch viele Fenster besitzt,
existiert eine genau definierte Hierarchie. Wenn man z.B. das
Konverter-Fenster schlie
t, werden alle Unter-Fenster (z.B. PictureList,
YAFAAnimOptions,...) automatisch geschlossen.
Da das Haupt-Fenster an der Spitze der Hierarchie steht, kann man mit dem
Schlie
en dieses Fensters das Programm beenden.
erdem dient das Haupt-Fenster als eine Art Icon Manager. F
r alle
Files, die bearbeitet werden etc. wird automatisch ein Icon erstellt.
Dieses wird dann im Haupt-Fenster dargestellt.
Wenn man dann ein solches Icon in ein anderes Fenster bewegt, wird - je
nach FileType - eine spezielle Aktion ausgef
@{b}Funktionen:@{ub}
                                                    @{" Converter   " link ConverterWindow}
                                                    @{" Projects    " link ProjectsWindow}
                                                    @{" Processor   " link ProcessorWindow}
                                                    @{" Player      " link PlayerWindow}
                                                    @{" TMaker      " link TMakerWindow}
                                                    @{" Preferences " link PreferencesWindow}
                                                    @{" PlugIns     " link PlugInsWindow}
                    @{" Icon Area " link IconArea}
                                                    @{" Icons       " link IconsWindow}
                                                    @{" DWA         " link DWAWindow}
                                                    @{" Log         " link LogWindow}
                                                    @{" Info        " link InfoWindow}
                                                    @{" Quit        " QUIT}
@{"   Add   " link IconFunctions} @{" Cleanup " link IconFunctions} @{"  Reset  " link IconFunctions} @{"  Load   " link IconFunctions} @{"  Save   " link IconFunctions}
@endnode
@node IconArea
@{b}Ikon-Arbeitsfl
che (Icon Area)@{ub}
Dieses Gebiet ist wie eine Arbeitsfl
che. Man kann Files dort plazieren,
verschieben oder bearbeiten.
Es gibt vier Ikons, die beim Starten von Wildfire automatisch
initialisiert werden. Wenn Sie ein anderes Ikon darauf fallen lassen,
wird eine vom Filetype abh
ngige Funktion ausgef
lleimer:     Zum L
schen von Ikons und Files.
               Die Voreinstellung ist, da
 nur die Icons von der
               Oberfl
che gel
scht werden. Man kann dieses Verhalten
               im Ikon-Fenster @{"Icons-Window" link IconsWindow} ver
ndern
Abspielger
t:  Zum Abspielen von Animationen
Anzeiger:      Zum Anzeigen von Bildern
Editor:        Zum Editieren oder Anzeigen von Texten
Welche externen Programme gestartet werden, kann man in den
Voreinstellungen
ndern.  @{" Preferences-Window" link PreferencesWindow}.
Auf der Unterseite des Fensters befinden sich noch einige Gadgets, die
r diverse Funktionen stehen, die Ikons beeinflussen.
Hinzuf
gen @{"(Add)" link IconFunctions} Aufr
umen @{"(Cleanup)" link IconFunctions} Zur
cksetzen @{"(Reset)" IconFunctions} Laden @{"(Load)" link IconFunctions} Speichern @{"(Save)" link IconFunctions}
@endnode
@node IconFunctions
@{b}Hinzuf
gen (Add)@{ub}
Mit Hilfe dieser Funktion kann man externe Files zur Arbeitsfl
hinzuf
Zum Beispiel kann man 20 verschiedene Bilder auf die Arbeitsfl
legen, sie dann auf das Anzeige-Ikon `werfen` und die `h
lichen`
Bilder mittels des M
lleimer Ikons l
schen.
@{b}Aufr
umen (Cleanup)@{ub}
Hiermit kann man die Arbeitsfl
che aufr
umen lassen.
@{b}Zur
cksetzen (Reset)@{ub}
Alle File-Ikons werden vom Arbeitsplatz gel
scht und die 4
Standard-Ikons werden an Ihren urspr
nglichen Positionen abgelegt.
@{b}Laden (Load)@{ub}
Ein zuvor gespeicherter Arbeitsplatz wird eingeladen.
Der Filename des Files, aus dem die Informationen geladen
werden, kann im Ikons-Fenster @{"(Icons-Window)" link IconsWindow} eingestellt werden.
@{b}Speichern (Save)@{ub}
Der derzeitige Arbeitsplatz wird gesichert.
Der Filename des Files, in dem die Informationen gespeichert
werden, kann im Ikons-Fenster @{"(Icons-Window)" link IconsWindow} eingestellt werden.
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Converter
@remark */
@remark /*************************************************************/
@node ConverterWindow
@{b}Einf
hrung@{ub}
Der Konverter ist ein Teil des Programmes, der sehr viele Aufgaben
zu erledigen hat.
Er lie
t Daten ein, l
t Spezial-Effekte auf diese Daten wirken
und speichert die Resultate wieder ab.
Im Gegensatz zu `
blichen` Programmen macht es f
r den Anwender kaum
einen Unterschied, ob nur einfache oder komplizierte Operationen
ausgef
hrt werden.
Beispiele:
1. Sie m
chten eine MPEG-Animation in eine IFF-Animation convertiern.
   Das ist einfach. W
hlen Sie das Eingabe-und das Ausgabefile,
   Stellen Sie die Parameter der IFF-Anim ein und dr
   Sie auf `Convert`
2. Sie m
chten die Bilder verkleinern, da Sie nicht gen
   Platz auf Ihrer Harddisk haben.
   Das ist einfach. Schalten Sie einfach den Prozessor an
   und f
gen Sie einen `Halve` Effekt hinzu.
3. Sie m
chten nur einen Teil der Animation konvertieren, z.B.
   die Bilder 31...54
   Das ist einfach.
ffnen Sie das `CRange` Fenster und geben
   Sie die Zahlen ein!
4. Sie m
chten eine kleine Animation vor einem gro
en Hintergrund
   erhalten.
   Das ist einfach. Geben Sie im Prozessor einen `Loadimage` Effekt
   und einen `Compose` Effekt ein und schon erhalten Sie das
   gew
nschte Resultat.
Man kann tausende solcher Beispiele auff
hren, alle w
ren einfach
zu bewerkstelligen.
@{b}Konverter-Fenster (Converter-Window)@{ub}
@{u}Eingabe (Input)@{uu}
Type               Auswahl des Eingabe-Types:
                    Animation - verschiedene Animationsarten
                    SinglePictures - Einzelbilder (datatypes werden
                                     unterst
                    BlackFrames - schwarze Bilder
                    Sequences - Bildsequenzen
Info               Anzeige von Informationen
ber die Eingabe-Animation
Related Options
ffnen der Optionsfenster @{"PictureList" link PictureListWindow},
                   @{"BlackFrames" link BlackFramesWindow} oder @{"Sequencen" link SequenceWindow} je nach Art der Eingabe
@{u}Ausgabe (Output)@{uu}
Type               Auswahl des Ausgabetypes:
                    YAFA - YAFA Animation
                    ANIM - IFF Animation
                    SinglePictures - Einzelbilder
                    NIL: - Kein Speichern
Info               Anzeige von Informationen
ber die Ausgabe-Animation
                   generated output-animation
Related Options
ffnen der Optionsfenster @{"YAFAOptions" link YAFAOptionsWindow},
                   @{"IFFOptions" link IFFOptionsWindow} oder @{"SinglePictures" link SinglePicturesWindow}
@{u}Optionen (Options)@{uu}
Annotation         Text oder File, welches in die YAFA-Animation mit
                   eingebunden werden kann
Range
ffnen des @{"Bereich-Fensters" link CRangeWindow} um den zu bearbeitenden
                   Bereich der Eingabe auszuw
Preview            Auswahl der Vorschau
                   (Keiner (none)/Fenster (window)/Bildschirm (screen))
Processor          Anschalten des Prozessors, um Spezialeffekte zuzulassen
@{u}Operation@{uu}
Save Session       Speichert alle Optionen, auch die Fensterpositionen
                   und die Processor-Einstellungen, falls der Processor
                   auf `ON` geschaltet ist
Load Session       L
dt eine gespeicherte Session wieder ein
Convert            Startet den Konverter
Alle Kombinationen von Eingabe-und Ausgabe sind m
glich. Eine
spezielle Kombination ist Eingabe=Ausgabe=`Einzel Bilder`
Diese Funktion ist nicht
berfl
ssig, sondern kann dazu benutzt
werden, verschiedene Bilder mit verschiedenen Namen auf einfachste
Weise in nummerierte Files umzubenennen.
Wenn `NIL:` als Ausgabe gew
hlt wird, werden keine Bilder gespeichert.
Dies eignet sich vorallem zum Testen von Prozessor-Scripts, die
sich noch in der Entwicklung befinden und wobei man auf das Speichern
verzichten kann, weil nur die Ausgabe betrachtet werden soll.
Der Konvertierungsvorgang kann jederzeit abgebrochen werden. Das
jeweilige Bild wird aber noch weiterberechnet. In den meisten F
kann man das Resultat trotz Abbruch verwenden.
@endnode
@node CRangeWindow
@{b}Konverter Bereich (CRange-Window)@{ub}
In diesem Fenster kann man einen Konvertierungsbereich f
die Eingabe ausw
hlen.
@{b}Funktionen@{ub}
State         ein/ausschalten der Bereichswahl
From          erstes Bild
To            letztes Bild, wird eine negative Zahl angegeben wird
              die Anzahl der Eingabe Bilder um diesen Wert verringert
Step          die Schrittweite, wenn z.B. nur jedes 2. Bild verwendet
              werden soll, w
hlt man 2
Remove loop   eine Voreinstellung zum l
schen der m
glichen `loop` bei
              IFF-Animationen
Wenn der `State` ausgeschaltet ist (disabled) werden alle Bilder
der Eingabe bearbeitet.
@endnode
@node IFFOptionsWindow
@{b}IFF Optionen (IFFOptions-Window)@{ub}
In diesem Fenster kann man diverse Einstellungen f
r IFF-Animationen
treffen.
@{b}Funktionen:@{ub}
Type        Art der Kompression
Colormap    dynamische oder statische (feste) Palette
Screenmode  Bildschirmmodus der beim Abspielen der Anim verwendet
            werden soll
@endnode
@node SinglePicturesWindow
@{b}Einzel Bild Optionen (SinglePictures-Window)@{ub}
Hier kann man Optionen einstellen, die die Erzeugung der
Einzelbilder beeinflussen.
@{b}Funktionen:@{ub}
Basename       Basisnamen der Bilder, die Bildnummer wird im Format
               ".%04d" an jedes Bild angeh
               z.B. "ram:pic" -> "ram:pic.0001", "ram:pic.0002"...
Shift Frames   Wert, der zu der Bild-Nummer addiert wird, bevor der
               Bildname erstellt wird
Screenmode     Bildschirmmodus der beim Anzeigen des Bildes verwendet
               werden soll
Type           an/ausschalten des Renderns
@endnode
@node YAFAOptionsWindow
@{b}YAFA Optionen (YAFAOptionsWindow)@{ub}
Alle Einstellungen, die YAFA-Animationen betreffen, werden hier
getroffen.
@{b}Funktionen:@{ub}
Image data        Art der Speicherung der Bilder
Colormap          dynamische oder statische Palette
Force Timecodes   Timecodes werden immer erzeugt
Speed             Geschwindigkeits-Voreinstellung f
r den YAFA-Player
                  (fps=50/Speed  (F
r PAL-Amigas))
Post Compression  Anschalten der XPK-Kompression
Compressor        Auswahl des Xpk-Kompressors
Mode              Auswahl des Xpk-Kompressions-Modes,
                  bitte lesen Sie die XPK-Anleitung f
r Details!
Delta Compression Auswahl des Delta-Kompressions-Modes
UC-Frames         Auswahl der Anzahl der ungepackten Delta-Bilder
UC-Mode           Auswahl des Types der ungepackten Delta-Bilder
Analysis
ffnen des @{"Analysis-Fensters" link AnalysisWindow} um einige
                  vordefinierte Einstellungen zu vergleichen
Import
bernahme der Einstellungen von einer YAFA-Anim
Load              Laden eines gespeicherten Setting-Files
Save              Speichern der Einstellungen in ein Settings-File
Anmerkung:
@{b)Delta-Modes@{ub} sind f
r Animationen geeignet, die - sich nicht sehr stark
ndernde Bilder - enthalten.
r alle anderen Animationen ist @{b)Chunky-XPK Fast-Kein Delta@{ub} eine gute
Auswahl. Wenn der Rechner, auf dem die Anim abespielt werden soll, zu
langsam ist, kann man die Animationen auch v
llig ungepackt -
@{b)Planar-Kein XPK-Kein Delta@{ub} - abspeichern.
@endnode
@node AnalysisWindow
@{b}Analysis-Fenster (Analysis-Window)@{ub}
Die Funktionen dieses Fensters sind angebracht, wenn Sie mit
den YAFA Einstellungen
berhaupt nichts anfangen k
nnen.
Sie k
nnen einige voreingestellte Settings ausprobieren lassen.
Die Ergebnisse (Gr
en-Profile) werden graphisch dargestellt und
die kleinste generierte Anim wird automatisch ausgew
hlt. Diese
Einstellungen k
nnen dann in die YAFA-Optionen
bernommen werden.
@{b}Funktionen:@{ub}
Frames        Anzahl der Bilder, die f
r jeden Test verwendet werden
              sollen
Run test      Starten des Tests
Results       Anzeige von diversen Informationen und der gew
hlten
              Einstellungen
Size Profile  Anzeige eines Gr
en-Profiles zu jeder berechneten
              Testanimation, die ausgew
hlte ist mit einer anderen
              Farbe dargestellt
Use           Die Einstellungen der ausgew
hlten YAFA-Animation
              werden
bernommen.
@endnode
@node PictureListWindow
@{b}Einzelbild-Liste (PictureList-Window)@{ub}
In diesem Fenster gibt es einige Funktionen, mit denen
man die Liste der zu Konvertierenden Bilder erweitern und
bearbeiten kann.
@{b}Funktionen:@{ub}
Add          Hinzuf
gen eines oder mehrerer Bilder
Add Reverse  Hinzuf
gen eines oder mehrerer Bilder in umgekehrter
             Reihenfolge
Add Dir      Hinzuf
gen einer ganzen Directory
Sort         Sortieren der ganzen Liste
Check        Bilder, die keine ILBM-Bilder sind und/oder nicht mit
             den Dimensionen des ersten Bildes (Breite/H
he/Tiefe)

bereinstimmen, werden entfernt.
Remove       Entfernt den ausgew
hlten Eintrag aus der Liste
Remove Range Entfernt die Eintr
ge die sich im definiertern
             Bereich (Range) befinden
Set Timecode Setzen des Timecodes f
r den ausgew
hlten Eintrag
Time Range   Setzen des Timecodes f
r Eintr
ge, die sich im
             definierten Bereich (Range) befinden
Show         Anzeigen des ausgew
hlten Bildes mittels @{"Visage" link Visage}
Picture Info Anzeige von Informationen
ber den ausgew
hlten Eintrag
From         Erstes Bild des Bereiches
To           Letztes Bild des Bereiches
Step         Schrittweite im Bereich, z.B.
berspringt 2 jedes 2. Bild
@endnode
@node BlackFramesWindow
@{b}Schwarze Bilder (BlackFrames-Window)@{ub}
Wenn Sie Animationen berechnen wollen, ohne eine vorgegebene Animation
zu benutzen - also nur unter Verwendung von Wildfire - ist diese
Einstellung sinnvoll. Als Beispiel k
nnte man einen rotierenden
rfel nehmen, auf den diverse Bilder gemappt sind.
@{b}Funktionen@{ub}
Frames     Anzahl der zu generierenden Bilder
Width      Breite der Bilder
Height     H
he der Bilder
Die `Schwarze Bilder` Eingabe ist eine Art Simulation einer
Bilder-Liste oder einer Animation. Das wichtigste dabei ist die
entsprechende Anzahl von Bildern einzustellen. Falls man die
Eingabegr
e nicht ben
tigt (z.B. l
dt man sp
ter mit `Loadimage`
ein Einzelbild in den Prozessor und benutzt dessen Gr
e) sollte
man die Breite und die H
he recht klein einstellen. (z.b. 1x1)
@endnode
@node SequenceWindow
@{b}Sequencen-Fenster@{ub}
Die Sequence-Eingabe ist eine Erweiterung der Einzelbild Modes
des Prozessors.
Einzelbilder und Bildsequencen k
nnen verwendet werden.
@{b}Funktionen@{ub}
Sequence  Kompletter Name eines Einzelbildes oder
          Basis-Name eine Bildsequence
Frames    Anzahl der zu verwendeten Eingabebilder
Loop      L
nge der Bildsequence
Shift     Verschiebung f
r die Z
hlvariable der Bildsequence
Show      Anzeigen des ausgew
hlten Bildes mit @{"Visage" link Visage}
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Projects
@remark */
@remark /*************************************************************/
@node ProjectsWindow
@{b}Projekte (Projects-Window)@{ub}
Die Animations-Projekte, die mit diesem Editor erstellt werden, sind
Aneinanderreihungen von YAFA-Animationen in Kombination mit Musik
oder ausf
hrbaren Befehlen.
Projekte werden als Texte abgespeichert, die per Maus im
@{"Player-Fenster" link PlayerWindow} oder direkt mit dem YAFA-Animationsabspieler
"yp" in der Shell mit der Option "-batch" gespielt werden k
nnen.
Projekte sind perfekt daf
r geeignet, gro
e Videos zu gestalten,
da man mit Hilfe des "yp" und des YAFA-Formats mehrere Anims aneinander
reihen kann, ohne das beim Abspielen zwischen den verschiedenen Anims
cken entstehen.
Weiterhin kann man nat
rlich k
rzere Animationen schneller ver
ndern,
als dies bei langen Animationen der Fall ist.
@{b}Funktionen:@{ub}
@{u}Animationen (Animations)@{uu}
Add            Einbinden einer YAFA-Anim (*)
Kill           Entfernen der ausgew
hlten Anim aus der Liste
Replace        Austauschen der ausgew
hlten Anim
Up/Down        Verschieben des ausgew
hlten Eintrags nach oben/unten
Local Range    Angabe des ersten und des letzten zu spielenden Bildes
                Beispiele: die Anim hat 100 Einzelbilder
                         1, 100  - genau ein Durchlauf
                         11,  50 -
berspringt die ersten 10 Bilder,
                                   spielt 40 Bilder ab
                         51, 250 - spielt die gesamte Anim 2 mal, der
                                   Beginn und das Ende sind um 50 Bilder
                                   verschoben
Global Range   Anzeige des Bereiches auf das gesamte Projekt bezogen
Info           Anzeige von Informationen
ber die Anim, au
erdem besteht
               die M
glichkeit, Einstellungen wie im @{"Player-Fenster" link PlayerWindow}
               zu treffen
Filmstrip
ffnen des @{"Filmstrip-Fensters" link FilmStripWindow}
@{u}Musik (Sounds)@{uu}
Add            Siehe (*) - nur f
r Protracker-Module, Samples oder
               ausf
hrbare Programme
Kill           Dito
Replace        Dito
Global Range   Einstellen der Globalen Bild-Nummer, bei der der Effekt
               beginnt/endet
               Ein ausf
hrbares Programm wird gestartet, sobald das
               Start-Bild erreicht ist
               Ein spezieller Fall f
r ausf
hrbare Programme ist die
               Einstellung 0,0. Alle diese Kommandos werden ausgef
               bevor der YAFA-Player die `Intuition` verbietet. Somit
               k
nnen auch Programme (wie z.b. CD-Player) benutzt
               werden, die eine Ausgabe haben
Type           Angabe des Effekt-Types
Edit
ffnen des jeweiligen Editor Fensters:
               @{"Module" link ModuleWindow}, @{"Sample" link SampleWindow} oder @{"Kommando" link CommandWindow}
@{u}Projekte (Project)@{uu}
Frames         Anzeige der Anzahl von Bildern des gesamten Projektes
Play selected  Abspielen des Projektes beginnend mit der ausgew
hlten Anim
Play all       Abspielen des gesamten Projektes
Profile
ffnen des @{"Profile-Fensters" link ProfileWindow}
Identify       Berechnen der Animation und der Bild Nummer aus einer
               gegebenen globalen Nummer
Save All       Abspeichern aller Bilder unter Verwendung des Bild-
               Basisnamens, der im @{"Converter" link ConverterWindow} Fenster eingegeben
               wurde
Clear          L
schen der Projekt-Liste
Project File   Auswahl des Projekt-Files, welches geladen/gespeichert
               werden soll
@endnode
@node ProfileWindow
@{b}Profil-Fenster (Profile-Window)@{ub}
Das Profile-Fenster dient zum
berblick der einzelnen Animationsbereiche
und der dazugeh
rigen Effekt-Bereiche.
@{b}Functions@{ub}
Animations     Anzeige von Balken, die die globalen Bereiche der
               jeweiligen Animationen darstellen
Sounds         dito f
r Effekte
Size-Profile   Anzeige eines Gr
en-Profils f
r das Projekt
Full View      Scaliert die Balken horizontal um das gesamte Projekt
               im Fenster anzeigen zu k
Lines          Anzahl der dargestellten Linien. Die beste Auswahl
               ist u.a. Abh
ngig vom verwendeten Zeichensatz
Mit Hilfe der Maustasten k
nnen die Bereiche f
r die Effekte gesetzt
werden:
Linke Taste    Verschieben des Startpunktes
Rechte Taste   Verschieben des Endpunktes
@endnode
@node ModuleWindow
@{b}Module-Fenster (Module-Window)@{ub}
Dieses Fenster erscheint, wenn der ausgew
hlte Eintrag ein
Protracker Module ist. Dieses Module wird mit dem internen Player
gespielt.
@{b}Funktionen:@{ub}
File        Filename der ver
ndert werden kann
Test        Anh
ren des Modules
Stop        Anhalten des Abspielens
@endnode
@node SampleWindow
@{b}Sample-Fenster (Sample-Window)@{ub}
Dieses Fenster erscheint, wenn der ausgew
hlte Eintrag ein
IFF 8SVX Sample ist.
@{b}Funktionen:@{ub}
File        Filename der ver
ndert werden kann
Test        Anh
ren des Samples
Channel     Auswahl des Audio Kanals (wird ignoriert wenn Stereo Samples
            abgespielt werden)
Repeat      Anzahl der Wiederholungen des Abspielens, bei einem Wert von
            0 wird das Sample endlos gespielt
Volume      Ver
nderung der Lautst
Stop        Anhalten des Abspielens
@endnode
@node CommandWindow
@{b}Kommando-Fenster (Command-Window)@{ub}
Hier kann man ausf
hrbare Programme hinzuf
String        Das Kommando, welches ausgef
hrt werden soll, z.B.
               "rx ARexx:EP_LoadModule.rexx Music:CUST.Electricity" oder
               "CDPLAY 4"
Test          Ausf
hren des Kommandos
@endnode
@node FilmStripWindow
@{b}Filmstreifen (Filmstrip-Window)@{ub}
In diesem Fenster kann man kleine Filmstreifen erstellen, ver
ndern
und abspielen.
Solch ein Streifen ist eine kleine Form der Animation oder eine
kurze Zusammenfassung eines ganzen Projektes.
Die Beispielanimationen im
berblendungs-Generator (Transition-Maker)
sind zum Beispiel solche Filme.
@{b}Animationen (Animation)@{ub}
Animation     Name der/des zu konvertierenden Animation/Projektes
From/To/Step  Bereich der Bilder, die im Film gespeichert werden sollen
Width         Breite des Films
Color         Art der zu generierenden Palette
MaxDepth      Maximale Tiefe auf CyberGraphX Bildschirmen
Compression   An-/Ausschalten der XPK-Kompression
Update        Starten des Konvertierungsvorgangs
@{b}Filme (Film)@{ub}
Film          Filename des Films
Rows/Cols     Angabe der Zeilen (rows) und Spalten (cols)
              f
r das anzeigen/abspielen
Load/Save     Laden/Speichern eines Films
Play          Abspielen des Films, zum Ver
ndern der Geschwindigkeit
              Zahlentasten verwenden
Append        Anh
ngen des ausgew
hlten Films an den derzeitigen Film
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Player
@remark */
@remark /*************************************************************/
@node PlayerWindow
@{b}Animationsabspieler (PlayerWindow)@{ub}
Dieses Fenster ist eine Art Benutzeroberfl
che f
r Externe
Animationsabspieler wie z.B. den frei erh
ltlichen YAFA-
Abspieler "yp" (er befindet sich bereits in der Wildfire Directory)
Einige der einstellbaren Funktionen wirken sich nur auf YAFA-Animationen
@{b}Animation@{ub}
File          Name einer Animation oder eines Wildfire-Projektes
Display       Auswahl der Echtzeit-transformationen des YP
Cache         Spielen der Animationen von Platte oder aus dem Cache
FrameBuffers  Cache-Puffer f
r YAFA-Animationen
LoadBuffer    Lade-Puffer f
r YAFA-Animationen
@{b}Informationen (Information)@{ub}
Animation     Anzeige von Informationen
ber die Animation
Shortcuts     Anzeige der Tastatuzrk
rzel f
r den YP
Falls die gew
hlte Animation eine YAFA oder eine IFF Animation ist,
werden im Animations-Info-Fenster ein Gr
enprofil gezeichnet und
einige Informationen
bder die Kompression angezeigt.
Das @{" Timecodes-Fenster " link TimeCodesWindow} kann
ber dieses Fenster
erreicht werden.
@{b}Animationsabspieler (Player)@{ub}
Output        Anzeige Typ
24Bit         Art der Anzeige von 15/24 Bit Animationen:
               Real : "native", Grafikkarte Vorausgesetzt
               DRGB : Dither-rgb, verwendet 7/8 Bit-Anzeige
               DRGB2: Dither-rgb2, verwendet 7/8 Bit-Anzeige
               Gray : Graustufen, verwendet 8 Bit-Anzeige
               Q332 : Einfache Quatisierung, verwendet 8 Bit-Anzeige
Wait          Falls diese Option angeschaltet ist, wartet der YP
              vor Beginn des Abspielens auf das Dr
cken der <Leertaste>
Screenmode    Auswahl des Bildschirmmodes (wenn Output=SCREEN)
Seit Version 3.74 werden @{" Truecolor " link TruecolorImages}-YAFA-Animationen
von YP und Wildfire unterst
@endnode
@node TimeCodesWindow
@{b}TimeCodes (TimeCodes-Window)@{ub}
In diesem fenster kann man Timecodes f
r YAFA-und IF Animationen
editieren.
Weiterhin k
nnen die Timecodes Importiert/exportiert werden.
Dadurch kann man sie auch grafisch mittels des @{" Envelope-Editors " link EnvelopeWindow}
bearbeiten.
@{b}Funktionen:@{ub}
From, To, Step    Bereich der ver
ndert wird
Set Timecode      Setzen eines einzelnen Timecodes
Time Range        Setzten aller Timecodes innerhalb des Bereiches
Import            Einladen eines vom Timecode-Editor oder vom
                  @{" EnvelopeAdvanced-Fenster " link EnvelopeAdvancedWindow} gespeicherten Files
Export            Abspeichern der derzeitigen Timecodes
Show              Anzeige des ausgew
hlten Einzelbildes der Anim
Play              Abspielen der Animation um die Timecodes zu testen
@endnode
@remark /*************************************************************/
@remark /*
@remark                            TMaker
@remark */
@remark /*************************************************************/
@node TMakerWindow
berblendungsgenerator (TMaker-Window)@{ub}
Mit Hilfe des
berblendungsgenerator (Transition-Maker oder auch kurz
TMaker) kann man vordefinierte
berblendungen zwischen zwei Animationen
oder zwei Einzelbildern generieren.
Vorallem beim Erstellen von Animations-Projekten ist dies sehr hilfreich.
Die Beispiel-Filmstrips stellen den derzeitig ausgew
hlten Effekt dar.
Links wird eine Animation `A`, rechts die Animation `B` und in der Mitte
die gew
hlte
berblendung `A->B` gespielt. Der Abspieler ist mit einer
niedrigen Priorit
t eingebunden, somit wird keine Rechenzeit verschwendet.
Es ist darauf zu achten, da
 die richtigen Beispielanimationen
(richtige Farbe und richtige Bildschirmtiefe) f
r Ihre Installation
benutzt werden. Auf der CD befindet sich eine Transition Directory,
in der sich verschiedene vorbereitete
berblendungen befinden.
Wenn die
berblendungen ohne vorherige Umrechnung sofort abgespielt
werden, haben Sie die richtigen
berblendungen installiert.
Da bisher nur YAFA-Animationen einwandfrei in Projekten
aneinandergef
gt werden k
nnen, ist auch nur dieses Ausgabeformat
unterst
@{b}Funktionen:@{ub}:
Input1         Eingabe Animation oder Bild  1
Input2         Eingabe Animation oder Bild  2
Output         Ausgabe Animation (die
berblendung)
Temp           Eine Directory f
r tempor
re Files, die beim Berechnen
               erstellt wird
CreateEX       Falls Sie keine Filmstrips f
r Ihre spezielle
               Konfiguration besitzen, k
nnen Sie hier Ihre
               Ein Druck auf diesen Knopf gen
gt und schon werden
               die Beispiel-Filme generiert. Dies kann auf langsamen
               Rechnern mehrere STunden dauern.
YAFAOpts       Ver
ndern der YAFA-Kompressions-Einstellungen
Preview        Vorschau an/ausschalten
Example        Beispiele an/ausschalten
               Da der Abspieler auf niedriger Priorit
uft, kann
               dies immer ausgeschaltet sein
Type           Auswahl des Ober-Types der Umblendung
Subtype        Auswahl des Unter-Types der Umblendung
CreateTemp     Erstellen der tempor
ren Files
               Diese Files m
ssen nur einmal erstellt werden, falls
               mehrere Umblendungen mit den selben Animationen berechnet
               werden sollen, z.B. um die Umblendungen zu testen
               Dies spart nat
rlich Rechenzeit
               Die `Convert` Funktion erstellt die Files (falls n
               selbstst
KillTemp       L
schen der tempor
ren Files
Play           Abspielen der Sequence Anim1-Umblendung-Anim2
Convert        Erstellen der Umblendung
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Preferences
@remark */
@remark /*************************************************************/
@node PreferencesWindow
@{b}Voreinstellungen (Preferences-Window)@{ub}
In dem Einstellungsfenster kann man die meisten Programmeigenschaften
und diverse Pfade etc. ver
ndern.
Alle ver
nderten Einstellungen zeigen sofort Wirkung, es ist
kein `Benutzen` o.
. Gadget zu bet
tigen.
@{b}Funktionen@{ub}
ScreenType         Auswahl des Typs des Wildfire-Bildschirms
Screenmode         Auswahl des Bildschormmodes
DisplayScreenmode  Auswahl des Bildschirmmodes f
r das Bilder-Anzeigen
ScreenFont         Auswahl des Zeichensatzes f
r den Bildschirm
IconManagerFont    Auswahl des Zeichensatzes f
r den Icon-Manager
ScreenColors       Auswahl der Farben f
r den WF-Bildschirm
Preset             Einige Farbvorgaben. "WF (modern)" wird empfohlen
Import             Laden der Farben
Export             Speichern der Farben
PlayerScreen       Name des Bildschirms, auf den der `YP` im Public-Screen
                   Modus die Animationen abspielt
DClickTime         Zeit in dem ein Doppelklick erkannt wird
ReqTimeOut         best
tigt Requester automatisch nach bestimmter Zeit
                   (in Sekunden)
Statistics         An/Ausschalten der Statistiken
Expertmode         An/Ausschalten der Sicherheitsabfragen
PPC                An/Ausschalten der PPC-Module
ClickToFront       bringt aktiviertes Fenster in den Vordergrund
OpenDWA
ffnen des @{" DWA-Fensters " link DWAWindow} beim Starten
PRVDither          Dithern der Preview-Bilder (thumbnails, filmstrips...)
Paths
ffnen des Directory-Fensters
Macros
ffnen des Macro-Fensters
File               der Filename des Voreinstellungs-Files
Save               Speichern der derzeitigen Einstellungen
Load               Laden der Einstellungen
@{b}Directory-Fenster (Paths-Window)@{ub}
In diesem Fenster kann man Voreinstellungen f
r die Standard-Directorys
treffen.
Animations           Animationen
Pictures             Bilder
Sounds               Musiken
Root                 Standard Wildfire Directory, am besten das Assign
                     WF:
YAFA Player          Abspieler f
r YAFA-animationen (Vorgabe: "yp")
Anim Player          Abspieler f
r IFF-Animationen  (Vorgabe: "vt")
MPEG-Player          Abspieler f
r MPEG-anims       (Vorgabe: "mp")
ImageProcessor       Externe Bildbearbeitung
                                      (Vorgabe: "ADPro mm=1000000")
Viewer               Bildanzeige Program        (Vorgabe: "@{"Visage" link Visage}")
Editor               Text-Editor                    (Vorgabe: "ed")
Das externe Bildbearbeitungsprogramm wird nur vom `AREXX`-Operator
Plugin ben
tigt.
@{b}Makros-Fenster (Macros-Window)@{ub}
In diesem Fenster kann man auf jede Funtionstaste ein Makro legen,
welches beim Dr
cken dieser Taste ausgef
hrt wird. Die `F10` kann
nicht belegt werden, da sich beim Dr
cken dieser Taste ein
File-Requester
ffnet, in dem man Makros ausw
hlen kann, das
dann ausgef
hrt wird.
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Icons
@remark */
@remark /*************************************************************/
@node IconsWindow
@{b}Ikons (Icons-Window)@{ub}
Das Ikons-Fenster hat 3 Hauptfunktionen:
ndern der Filetypes von Ikons auf der Benutzeroberfl
-Einstellen von die Benutzeroberfl
che betreffenden Optionen
-Erstellen von Ikons mit fast unbegrenzter Gr
e und Qualit
@{b}Optionen (Options)@{ub}
File               Name des Files, welches die Oberfl
chen-
                   Informationen aufnimmt, wenn sie gespeichert
                   werden
Trashcan-Action    Remove Icon: L
scht nur das Ikon von der Oberfl
                   Delete File: L
scht das File von der Platte
@{b}Ikon-Erstellung (Icon-Saver):@{ub}
Image1             Name des ersten Bildes, aus dem das Ion erstellt
                   werden soll
Image2             Optionales zweites Bild
Icon               Name des zu generierenden Ikons
Color              Art der Palette, die erstellt wird
                   Color:  Farbige Palette
                   Gray:   Graustufen
Width              Vorgabe der Breite des Ikons, die H
he ergibt
                   sich aus dem Aspect des ersten Bildes
Depth              Tiefe des Ikons in Bit`s
Convert            Beim dr
cken auf den `Convert` Knopf werden
                   die Bilder geladen, auf die entsprechenden
                   Gr
en scaliert und mittels der derzeitigen
                   Bildschirmfarben gerendert. Wenn z.B. Ikons
                   f
r die Workbench erstellt werden sollen,
                   stellen Sie den Public-Screen Modus in den
                   Preferences ein und w
hlen Sie einfach
                   die Workbench als Public Screen.
ndern des Filetypes:@{ub}
Falls Wildfire die Art eines externen Files nicht korrekt erkennen
sollte, k
nnen das entsprechende Ikon von der Benutzeroberfl
auf das Ikon-Fenster ziehen und fallen lassen. Sofort wird ein
weiteres Fenster ge
ffnet, in dem Sie den richtigen Type eingeben
nnen.
@endnode
@remark /*************************************************************/
@remark /*
@remark                              DWA
@remark */
@remark /*************************************************************/
@node DWAWindow
@{b}DWA-Fenster (DWA-Window)@{ub}
Mit Hilfe dieses Fensters kann man jedes Wildfire Fenster
ffnen,
ohne sich durch die Hierarchie von WF zu klicken. Nach dem
Doppelklicken oder die Best
tigung mit Enter wird das selektierte
Fenster und alle Fenster, die in der entsprechenden Hierarchie
ber liegen, ge
ffnet.
Wenn Sie die "OpenDWA"-Option in dem @{"Voreinstellungs-Fenster" link PreferencesWindow}
gesetzt haben, wird das DWA-Fenster sofort beim start ge
ffnet
@endnode
@remark /*************************************************************/
@remark /*
@remark                              Log
@remark */
@remark /*************************************************************/
@node LogWindow
@{b}Logbuch (Log-Window)@{ub}
Alle Statistiken, Warnungen und einige weiter Informationen
werden in diesem Fenster gesammelt und angezeigt.
rlich kann man dies auch ausschalten.
@{b}Funktionen@{ub}:
State           An/Ausschalten des Logbuches
Edit            Editieren des Logbuches
Delete          L
schen des Logbuches
Clear           L
schen des Puffer
Load            Einladen des Logbuches
Save            Abspeichern des Logbuches
Verbose         An/Ausschalten der sofortigen Anzeige
SaveAtExit      An/Ausschalten des Abspeichern des Logbuches beim
                beenden des Programs
@endnode
@node InfoWindow
@{b}Informationen (Info-Window)@{ub}
Dieses Fenster enth
lt einige wichtige Informationen wie z.B.
den vorhandenen Speicher, das Datum, den benutzten Speicher
und diverse Programm-Informationen
@endnode
@remark /*************************************************************/
@remark /*
@remark                            PlugIns
@remark */
@remark /*************************************************************/
@node PlugInsWindow
@{b}Plugins (PlugIns-Window)@{ub}
Im PlugIns-Fenster kann man Wildfire`s externe-Hilfsprogramme, sogenannte
"General Plugins" ausw
hlen und starten.
@{b}Funktionen@{ub}
Add           Hinzuf
gen eines oder mehrerer Plugins
Delete        L
schen des ausgew
hlten Plugins
SavePrefs     Speichern der Einstellunegn eines Plugins
Open          Aktivierung des Plugins
Close         Deaktivierung des Plugins
Die "SavePrefs"-Funktion speichert die Einstellungen, die derzeit im
PlugIn getroffen sind. Au
erdem wird mit vermert, ob das PlugIn
ffnet ist oder nicht. Falls es offen war, wird auch beim n
chsten
Start dieses Plugin ge
ffnet.
@{b}Vorhandene PlugIns@{ub}
 @{"  ColorWheel     " link gnColorWheel}
 @{"  Command        " link gnCommand}
 @{"  ConvertImages  " link gnConvertImages}
 @{"  CountPlugIns   " link gnCountPlugIns}
 @{"  GrabWindow     " link gnGrabWindow}
 @{"  Patch          " link gnPatch}
 @{"  TileImage      " link gnTileImage}
 @{"  SlideShow      " link gnSlideShow}
 @{"  XAnim          " link gnXAnim}
@endnode
@node gnColorWheel
@{b}ColorWheel-PlugIn@{ub}
Dieses Plugin ist dazu bestimmt, dem Anwender bei der Auswahl von Farben
r diverse Effekte zu helfen.
hlen Sie einfach eine Farbe Ihrer Wahl und
bernehmen Sie die unten
angezeigten Farbwerte in den jeweiligen Effekt.
@endnode
@node gnPatch
@{b}Patch-PlugIn@{ub}
Dieses Plugin wurde geschaffen, um das patchen von (ausf
hrbaren)
Programmen zu erleichtern.
Zur Zeit werden nur die SAS-Tools "scompare" und "spatch" unterst
@{u}Erstellen von Patches@{uu}
 *Erstellen Sie eine Hauptdirectory, z.B. "update"
 *In dieser Directory erstellen Sie zwei weitere "new" und "old"
 *copieren Sie alle "alten" files (diejenigen, die upgedatet werden
  sollen) in die "old" Directory und die "neuen" Files in die "new"
  Directory
cken Sie auf den "Generate"-Knopf
 Hinweise: 1) Verschieben Sie nicht Ihre Files in diese Directorys,
              da gleiche Files automatisch gel
scht werden
           2) Zur Zeit geschieht der Vergleich von Files nur
ber die
              L
           3) Als Resultat erhalten Sie eine Directory mit dem Namen
              "patches" Darin sind die Patch-Files enthalten
@{u}Patchen der Programme@{uu}
 *Erstellen Sie eine Hauptdirectory, z.B. "update"
 *verschieben Sie die "patches" Directory dort hinein
 *Erstellen Sie in der Hauptdirectory eine Directory Namens "old"
 *Kopieren Sie die "alten" Files in die "old" Directory
cken Sie auf "Apply"
 Hinweise: 1) Es ist egal ob Sie alle Files oder nur die zu patchenden
              Files in die "old" Directory kopieren
           2) Als Resultat erhalten Sie eine neue Directory Namens
              "new" in der sich die "neuen" Files befinden
@{u}Hinweise@{uu}
 1) Um Programme zu patchen, wird das frei erh
ltliche Program
    "spatch" ben
 2) Um Patch-Files zu generieren, wird das Program "scompare"
    ben
tigt, welches nicht frei erh
ltlich ist.
 3) Zur Zeit werden keine Unter-Directorys unterst
tzt, dies
    ist unserer Meinung nach auch nicht notwendig.
@endnode
@node gnCommand
@{b}Kommande-PlugIn@{ub}
Das Kommando-Plugin f
hrt die eingegebene Zeichenkette als
Wildfire-ARexx-Kommando aus.
Zum testen komplizierter zu erstellender Makros ist dies z.B. zu
empfehlen.
@endnode
@node gnConvertImages
@{b}ConvertImages-PlugIn@{ub}
Dieses Plugin Konvertiert eine Directory mit Bildern unter Beibehaltung
der Filenamen.
Falls Sie zum Beipiel eine Directory mit verschiedenen Bildformaten
besitzen und diese Bilder alle als z.B. png-Bilder erhalten m
chten,
nnen Sie dieses Plugin einsetzen.
Die File-Endung kann im "Extension"-Gadget angegeben werden, falls
Sie dieses Gadget frei lassen, wird die ENdung der Namen nicht
ndert.
Falls die Processor-Option angeschaltet ist, wird das derzeitige
Processor-Script (jeweils f
r Bild 1) f
r jedes Bild ausgef
Das Ausgabe-Format wird wie immer im @{"Savers-Fenster" link SaversWindow} des
Processors eingestellt.
@endnode
@node gnCountPlugIns
@{b}CountPlugIns-PlugIn@{ub}
Dieses Plugin zeigt einige Statistiken
ber die initialisierten
Plugins einschlie
lich Operatoren, Saver und Generelle Plugins.
Dies ist ein Beispiel-Plugin, welches im demn
chst erscheinenden
Entwickler-Kit enthalten sein wird.
@endnode
@node gnSlideShow
@{b}SlideShow-PlugIn@{ub}
Mittels des Slide-Show Plugins kann man sehr einfach kleine
Slideshows erstellen.
Es enth
lt viele Funktionen, mit denen man die Bild-Liste erstellen,
ndern, speichern und einladen kann.
Die Slideshow wird mittels des externen Programs
"@{"Visage" link Visage}" von Magnus Holmgren angezeigt. Dieses Program wurde u.a.
ausgew
hlt, da es beim anzeigen der Bilder weiterl
@{b}Funktionen:@{ub}
 Add         Hinzuf
gen eines oder mehrerer Bilder zur Liste
 AddDir          Hinzuf
gen einer ganzen Directory zur Liste
 From, To, Step  Bereich
 Remove          L
schen des ausgew
hlten Bildes aus der Liste
 Remove Range    L
schen aller Bilder des Bereiches aus der Liste
 Delete          L
schen des ausgew
hlten Bildes
 File            File zum Laden/Speichern der Bilderliste
 Save            Speichern der derzeitigen Bilderliste
 Load            Laden einer Bilderliste
 Clear           L
schen der Eintr
ge in der Liste
 Show            Anzeigen des ausgew
hlten Bildes
 Delay           Pause zwischen zwei Bildern beim anzeigen
 Go              Ausf
hren der Slideshow
Der einzige Weg, die Slidesho zu unterbrechen, ist das mehrmalige
cken der rechten Maustaste.
Die Anzahl der ben
tigten Klicks h
ngt von der L
nge der Liste ab.
@endnode
@node gnGrabWindow
@{b}GrabWindow-PlugIn@{ub}
Mittels dieses Plugins kann man Fenster oder Bildschirme abspeichern.
Das Ausgabeformat wird wie immer im @{"Savers-Fenster" link SaversWindow} des
Processor eingestellt.
@endnode
@node gnTileImage
@{b}TileImage-PlugIn@{ub}
Dieses Plugin zerlegt ein Bild in kleine Bereiche der selben Gr
Das Ausgabe-Format wird wie immer im @{"Savers-Fenster" link SaversWindow} des
Processor eingestellt.
@{b}Funktionen:@{ub}
 Input            Eingabe Bild
 Output        Basisname der zu generierenden Bilder
 xCount        Anzahl der Teile in x-Richtung
 yCount        Anzahl der Teile in y-Richtung
@{b}Hinweise:@{ub}
 1. Letztendlich erh
lt man xCount*yCount Fragment mit
    den Namen "output.0001", "output.0002", ...
    Der Z
hler l
uft von der unteren linken Ecke zur
    oberen rechten Ecke.
 2. Die Summe der generierten Teilbereiche mu
 *exakt* der
    Bildgr
e entsprechen. Zum Beispiel kann man ein Bild der
    Gr
e 640x480 Pixel nicht in 3x7 Fragmente unterteilen.
 3. Nun gut, die Idee f
r dieses PlugIn ist wirklich nicht von uns :-)
@endnode
@node gnXAnim
@{b}XAnim-PlugIn@{ub}
Dieses Plugin benutzt das Program XAnim um Animationen in
Einzelbilder zu zerlegen. (Tiefe 8 oder 24 Bit)
Da XAnim fast jedes Animationsformat unterst
tzt, kann man dieses
Plugin als ein "universelles Animations-Loader" Modul f
r Wildfire
verstehen.
@{b}Funktionen:@{ub}
 Animation      Animation, die zerlegt werden soll
 Output        Basisname der zu erstellenden Bilder
 XAnim          XAnim-Pfad (siehe unten)
 Convert        Start des Konvertierungsvorgangs
@{b}Hinweise:@{ub}
 1. Es gibt viele Amiga-portierungen von XAnim. Aber die meisten
    unterst
tzen nicht das abspeichern von Einzelbildern, da sie
    als Animations-Player vorgesehen sind. Aber das Program
    "AmiXAnim" von Joop van de Wege ist in der Lage, 8-und 24 Bit
    Bilder zu speichern.
 2. Da sicherlich mehrere XAnim-Ports auf Ihrer Festplatte sein k
    (z.B. die neuste Portierung, eine X11 Version, die Joop van de Wege
    Version,...) mu
 der Pfad genau angegeben werden.
    Dies ist normalerweise: "wf:tools/AmiXAnim".
 3. Bitte unterbrechen Sie XAnim nicht beim cnvertieren!
    Ansonsten kann es vorkommen, das es abst
rzt und der validierungs-
    Vorgang Ihrer Festplatte dauert meistens l
nger als die
    Konvertierung gedauert h
@{b}Copyright Hinweise:@{ub}
 1. XAnim Copyright (C) 1990,1991,1992,1993,1994,1995,1996 by Mark Podlipec.
    All rights reserved.
 2. Readme-file of "AmiXAnim"
    Short:    Xanim for Amiga BETA_6. 3.x+AGA or gfxcard required!
    Author:   Joop van de Wege
    Uploader: [e-mail]
    Type:     gfx/show
    This is the BETA_6 version of my port of Xanim to the Amiga. It requires
    3.x and AGA or a graphics card and 3.x, needs atleast a stack of 10000!!
    It is able to play back:
    Quicktime movies, AVI (windows), DL and FLI/FLC
    There is support for 16/24bit Qt/AVI
    Only support 256 colors and not less at the moment.
    Dithering 16/24bit anims to 8bit might/might not work.
    Shell only.
    Save IFF pics possible 8bit or 24bit.
    (use option +Di8filename or +Di24filename; filename can be any valid AmigaDOS
    path+file, there is no SPACE between the option +Di8/+Di24 and the filename!.
    Files will be automatically numbered from 0-n. 8/24bit saving should work for
    anyone having 3.x with or without a 256 color mode.
    NEW NEW NEW
    - 24bit display on the Merlin enabled and possible to center animations. Tell me
      if you like it. Please don't select 16bit from the screenmode requester from
      the Merlin. It won't do any harm but you'll be watching a black display!!!!
    - Centering on Amiga displays too.
    - Support for Cybergfx 8/24bit
      8bit is tested and should work. 24bit not tested but should work too.
      Please *report* any problems!!!
    - Dumped reqtools. Now using ASL.
    8bit saving works now too. You won't need a 256 color display anymore. No
    display will be opened/required when using the +Di8 and +Di24 options.
    Kickstart 3.x still required.
    Fix for the width not dividable through 8. Display and save of any width
    should work now.
    If problems still exist please report.!
    Code for gfxcards included:
    Merlin        8 and 24bit enabled and working. NOT 16bit.
    EGS            (largely untested, don't have one ;-) )
    PicassoII           (            ,,                       )
    Cybergfx            8 and 24bit
    I you have one and know how to program, please have a look at the supplied
    code and tell me what I'm doing wrong.
    Support for: RetinaZ2/Z3 and fast c2p is in the works.
    If you have such a card and know how to program the beasty please have
    alook at the supplied example of the Merlin. Try to substitute your code
    for mine. If it is not clear please free feel to email me at:
    [e-mail]
    Complete source will be available in the final or later BETA releases!
    Type Xamiga +h or -h for help.
    NOTE the last main option 'D' :)
    Send questions/remarks/bugs/anything to:
    [e-mail]
@endnode
@remark /*************************************************************/
@remark /*
@remark                            FAQ
@remark */
@remark /*************************************************************/
@node FAQ
@{b}H
ufig gestellte Fragen (Frequently Asked Questions)@{ub}
 Q: Wildfire st
rzt auf meinem Rechner ab, ich habe einen 68040
    Processor.
 A: Versuchen Sie, ob der `Patch for 68040 bug in
    "mathieeesingbas.library" V40` MathPatch.lha diesen Fehler behebt!
 Q: Arbeitet der Transition-Maker nicht im Demo-Mode?
 A: Seit Version 3.90 funktioniert er auch im Demo-Mode!
 Q: Wildfire st
rzt auf meinem CyberGFX-System ab!
 A: Falls Sie eine alte Version der Cyber-GFX Software benutzen,
    installieren Sie bitte das `patchgels` Program.  Sie finden es im
    `draggadget.lha` Archive in der Bonus Directory auf der CD.  Sie k
    auch die neuste Version des Drag-gadgets aus dem Internet heraus
    laden.                 aminet/dev/gui/draggadget*.lha
    Kopieren Sie das neue drag.gadget in die Wildfire/System/ directory
    und ersetzen Sie (falls Sie eine alte Version besitzen!) das
    drag.gadget.
 Q: Wildfire fragt nach der amigaguide.library V37 beim Starten, aber
    ich habe sie doch installiert!!!
 A: Kontrollieren Sie bitte, ob Ihre Startup-sequence (oder
    user-startup) folgende Zeilen enth
     assign libs: hd0:classes add
     adddatatypes refresh quiet               (seit OS3.1)
 Q: Welche Assigns etc. sind n
tig, um Wildfire zu starten ?
 A: Wildfire arbeitet, wenn man (z.B.  beim booten ohne
    Startup-Sequence) folgende Zeilen eingibt:
     setpatch
     assign libs: hd0:classes add
     adddatatypes refresh quiet
     stack 10000
     wf
    Danach funktionieren fast alle Teile des Programmes einwandfrei.  Das
    einzigste zu erkennende Problem ist, da
 die nline-Hilfe als normaler
    Text angezeigt wird.
 Q: Gibt es Pl
ne, eine PPC Version von Wildfire zu erstellen ?
 A: Ja, die PPC Version wird bald erh
ltlich sein.
 Q: Gibt es Pl
ne, eine p.OS Version von Wildfire zu erstellen ?
 A: Ja, wir arbeiten daran!
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Processor
@remark */
@remark /*************************************************************/
@node ProcessorWindow
@{b}Effekt-Prozessor (Processor-Window)@{ub}
@{u}Einf
hrung@{uu}
Der Prozessor ist Wildfire`s herausragende Bildbearbeitungseinheit,
die als PlugIn zwischen die Ein-und Ausgabe des Konverters geschaltet
werden kann.
Wenn Sie das prinzipielle @{"Konzept" link pcConcept} dieser Architetur verstanden
haben, ist es f
r Sie spielend m
glich, komplizierte und einfache
Effekte zu generieren.
@{b}Funktionen:@{ub}
@{u}Prozess-Skripte (Process-Script)@{uu}
Add
ffnen des @{" Operators-Fenster " link PCAddWindow} zum hinzuf
gen eines Effektes zur Liste
Kill             L
schen des ausgew
hlten Eintrags
Duplicate        Duplizierung des ausgew
hlten Eintrags
Import           Einf
gen eines abgespeicherten Process-Skripts
Edit
ffnen des Einstellungs-Fensters f
r den Operator
Up               Verschieben des Eintrags nach oben
Down             Verschieben des Eintrags nach unten
Visible/Hidden   Eintr
ge, die "Hidden" sind, werden bei angeschaltetem
                 Falten (folding) verborgen
Enabled/Disabled Ein-Ausschalten des gew
hlten Eintrags
Folding          Faltung ein-ausschalten
Range            der BildBereich, in dem der Operator g
ltig ist
                  from: erstes Bild
                  to  : letztes Bild
                  step: Schrittweite
                        Positive Werte:
                         Bei jedem <step>. Bild ist der Operator an
                        Negative Werte:
                         Bei jedem <0-step>. Bild ist der Operator aus
                 Es kann vorkommen, da
 man Operatoren einbinden mu
                 die nur ein einziges mal ausgef
hrt werden m
ssen,
                 z.B. in manchen F
llen der "Loadimage" Operator.
                 Wenn man den Bereich auf (0 0 1) stellt, wird der
                 benutzte Befehl beim ersten Bild, bei dem der Prozessor
                 gestarted wurde, ausgef
                 (Im Einzelbild-Modus kann das jedes beliebige Bild sein)
Die Faltung ist ein n
tzliches Instrument, um Skripts
bersichtlicher
zu gestalten. Wenn eine bestimmte Gruppe von Effekten einwandfrei
funktioniert, sollte man sie verbergen und zur Vereinfachung nur
einen Kommentar stehen lassen, der Auskunft
ber den Effekt und den
Bereich in dem er wirkt, gibt.
@{u}Optionen (Options):@{uu}
Mode           Farb-Modus f
r die berechneten (gerenderte) Bilder
Dither         Dither-Modus, der beim Rendern benutzt wird
Depth          Tiefe, die beim Rendern benutzt wird, die folgenden
               Bildtiefen werden derzeit unterst
                1...8 (Gerenderte Bilder mit Palette),
                15/24 (@{" Truecolor " link TruecolorImages} Bilder)
CSkip          Anzahl der Farben, die nicht benutzt werden, dies ist
               zum Beispiel zum berechnen von Workbench Hintergr
               geeignet
Scale          @{" Proces-Scale-Wert " link pcScale}
BGRed,         Hintergrundfarbe, die den Wert f
r die "schwarze" Farbe
BGGreen,       angibt, die bei den vielen Bildtransformationen zu sehen
BGBlue         ist, Rot-Gr
n-Blau Komponente
Smooth         global intensity of smoothing for various operators
Single Image
ffnen des @{" SinglePicture-Fenster " link PCSinglePictureWindow} um Einzelbilder zu bearbeiten
Variables
ffnen des @{" Variables-Fenster     " link VariablesWindow} um Zeitabh
ngige
               Animations-Parameter zu erstellen
StoryBoard
ffnen des @{" StoryBoard-Fensters   " link StoryBoardWindow} um das derzeitige Skript grafisch
               darzustellen
Savers
ffnen des @{" Savers-Fenster        " link SaversWindow} um das Speicherformat
               f
r True-Color Bilder zu bestimmen
Palette
ffnen des @{" Palette-Fenster       " link PaletteWindow} um eine FESTE Palette zu erstellen
Calculator
ffnen des @{" Calculator-Fenster    " link CalculatorWindow}, um Werte zu berechnen
File           Filename zum laden/speichern von Prozess-Skripten
Load           Einladen eines Prozess-Skriptes
Save           Speichern eines Prozess-Skriptes, aller Variablen und der
               Palette als Prozess-File
Clear          L
schen des Prozess-Skriptes, die Variablen bleiben
               erhalten
@{b}Weitere Hilfreiche Tastenkombinationen:@{ub}
<del>            L
schen des gew
ten Eintrags
<leertaste>      "Test Process" vom @{" SinglePicture-Fenster " link PCSinglePictureWindow}
<v>              An/ausschalten des @{" Preview " link ProcessorPreview}
<hoch>,<runter>  scrollen durch das Prozessor-Skript
<links>          Wenn "folding=off" Eintrag auf sichtbar schalten
<links>          Wenn "folding=on"  Sichtbarmachen des ganzen Processes
<rechts>         Eintrag auf unsichtbar schalten
<n>              An/Ausschalten des Eintrags
@endnode
@node pcConcept
@{b}Das Konzept@{ub}
Ein normaler Animations-Konvertierer wie z.B. Mainactor liest
einen Eingabe-"Stream" aus Bildern und schreibt einen Ausgabe-
"Stream" auf die Festplatte.
(Der komplizierte Prozess des (de)komprimierens verschiedener
Animationsformate bleibt hierbei unbeachtet)
Der Konverter von Wildfire erweitert dieses einfach Konzept
mittels einer PlugIn Architektur.
Man kann so viele Ver
nderungen, wie man m
chte, zwischen
Ein-und Ausgabe einschieben ("PlugIn"). Diese Ver
nderungen
werden mittels Operatoren realisiert.
Zum Beispiel kann man eine Eingabeanimation verkleinern, in den
man einen Halve (Halbierung) Operator einschiebt.
Eine Erweiterung dieses Konzepts ist die Benutzung von Tempor
Puffern, die als "TEMP-Puffer" bezeichnet werden.
Jedes Wildfire-Plugin benutzt mindestens 2 Puffer, einen Eingabe-
und einen Ausgabe Puffer.
Der "normale" Puffer, der vom Konverter generiert wird, wird
"STREAM" genannt.
Es gibt 8 Tempor
re Puffer mit den Namen "TEMP1"..."TEMP8".
Mit diesen Bezeichnungen sieht eine Halbierung einer Animation
folgenderma
en aus:
Eingabe
  ->STREAM -> Halve -> STREAM
                         I
                       Ausgabe
Das Konzept der TEMP-Puffer ist noch wesentlich m
chtiger.
Zum Beispiel kann man damit eine Animation erzeugen, welche
die Eingabe-Animation als grauen Hintergrund und au
erdem
als kleinen farbigen Vordergrund enth
Dazu ben
tigt man einen Scale-, ColorToGray- und einen Compose
Operator.
Schematisch w
rde dies so aussehen:
Eingabe
  ->STREAM -> Scale       -> TEMP1  )
                                     > Compose -> STREAM
           -> ColorToGray -> STREAM )               I
                                                  Ausgabe
Aber dieses Konzept erlaubt Ihnen nicht die Generierung
komplizierter Effekte, wie z.B. eine auf-und abspringende
Animation vor einer zerschmelzenden Animation.
Somit ist eine weitere Ver
nderung n
tig: Zeitlich Ver
nderbare
Animationsparameter.
Zum Beispiel kann man damit ganz einfach eine rotierende Animation
erstellen. Alles was man dazu ben
tigt ist der Rotate-PlugIn.
Man l
t einfach den Rotations-Winkel von 0 bis 360 Grad laufen.
Gehen wir davon aus, da
 die Animation 120 Bilder besitzt. Um sie
in eine rotierende Animation umzuwandeln, mu
 man den Rotate-Operator
gen und eine ver
nderliche Variable (Envelope) erzeugen,
die ihren Wert innerhalb der 120 Bilder von 0 bis 360 Grad
ndert
und diese Variable dann als Rotate-amount einsetzen.
Der Envelope besteht aus zwei Punkten, bei Bild 0 der Wert 0
und bei Bild 120 der Wert 360.
Die Einstellung des Wertes 0 bei Bild 0 - welches nie erreicht wird,
da das erste Bild die Nummer 1 hat - bewirkt, da
 wir eine
sauber rotierende Animation erhalten.
Wenn Sie dieses Konzept verstanden haben, k
nnen Sie mit Wildfire
so gut wie alles machen.
Noch ein Beispiel:
Vier verschiedene Animationen werden kombiniert, nachdem wir eine
Twirl-Effekt auf die erste, einen Negative-Effekt auf die zweite,
einen Cube-Effekt auf die dritte und einen Posterise-Effekt auf
die vierte Anim angewandt haben.
Eingabe
  ->STREAM -> Twirl ->STREAM                     )
                                                  > Compose -> STREAM                                     )
          LoadImage ->TEMP1 -> Negative -> TEMP1 )                                                         )
                                                                                                            > Compose -> STREAM
                                             LoadImage -> TEMP1 -> Cube      -> TEMP1 )                    )               I
                                                                                       > Compose -> TEMP1 )              Ausgabe
                                             LoadImage -> TEMP2 -> Poszerise -> TEMP2 )
Dieses Beispiel sieht nicht sehr sch
n aus, aber zeigt, da
einzige Einschr
nkung Ihre eigene Kreativit
t ist.
@endnode
@node pcQuant3D
@{b}3D-Quantisierungs-Wert@{ub}
Dieser wichtige Parameter beeinflu
t die Qualit
t und die
Geschwindigkeit, mit der Bilder von den 3D Effekten erzeugt/ver
ndert
werden.
Der Wert gibt an, wie viele Pixel wie ein Punkt transformiert werden.
Wenn Quandt3D z.B. auf 1 gesetzt ist, wird das Bild Pixel f
r Pixel
bearbeitet.
here Werte erzeugen eine Approximation des Bildes durch Rechtecke.
Die Gr
e der Rechtecke entspricht dem Quant3D Wert.
Wenn z.B. ein Wert von 3 verwendet wird, berechnet das Program die 3D
Effekte mittels Rechtecken der Gr
e 3x3. Die Farbe jedes Rechtecks wird
anhand der Farben der 9 Pixel interpoliert.
Es mag sein, da
 das Resultat qualitativ minderwertig aussieht, jedoch
geschieht die Berechnung selbst kompliziertester 3D Effekte auf schnellen
Rechnern fast in Echtzeit.
Dieser Wert dient vorallem dazu, um die vielen Parameter ver
ndern zu
nnen und recht schnell eine Vorschau des Resultates zu erhalten.
Weiterhin wird der Speicherverbrauch der 3D Buffer Quadratisch reduziert!
Bei einem Wert von 2 ben
tigt man nur 25% des erforderlichen Speichers.
(Im Vergleich zu einem Wert von 1)
Kleinere Werte als 1 k
nnen auch verwendet werden. Dadurch wird eine
andere Approximation gestartet. Das kann n
tig sein, falls Bilder nach
der Kombination von mehreren 3D-Effekten sehr stark deformiert werden.
Ein Wert von 0.5 z.B. ruft eine Interpolation von einem Bildpunkt durch 4
Rechtecke hervor! Dies verbraucht nat
rlich wesentlich mehr Speicher und
ist auch wesentlich Rechenzeitintensiver als ein Wert von 1, aber in
speziellen F
llen erh
lt man dadurch Bilder extrem hoher Qualit
@endnode
@node pcScale
@{b}Process-Skalierungs-Wert@{ub}
Diese auf den ersten Blick unscheinbare Option ist ein wahres
Mega-Feature! Hiermit kann man Prozessor-Skripte, die f
r eine bestimmte
Bildgr
e gedacht sind, auf andere Bildgr
en umrechnen.
Beispiel: Man hat eine gro
es Projekt mit 1000 Bildern erstellt,
          wobei die Bilder eine Gr
e von 320x256 Pixeln besitzen.
          Nun m
chte man schnell eine Vorschau-Animation mit der
          halben Gr
e berechnen.
          Dazu setzt man einfach den Scale-Wert auf 0.5
Es liegt in der Natur einer solchen Eigenschaft, da
 es einige wenige
Einschr
nkungen gibt:
 *die derzeitige Bild-Sequence mu
 den gleichen Aspekt besitzen,
  wie die Sequence, f
r die das Skript erstellt wurde
 *einige sehr spezielle Operatoren k
nnen nicht verwendet werden,
  z.B. kann die Text-Gr
e des Font-Operators nicht kontinuierlich
  ver
ndert werden
Aber da man (kurzzeitig) z.B. diesen Operator ersetzen kann, stellt dies
eigentlich keine gro
e Einschr
nkung dar.
An eine Sache sollten Sie immer denken, durch das Ver
ndern des
Prozess-Skalierungs-Wertes werden alle Parameter, die in Pixeln
vorliegen, auch ver
ndert.
Dies kann recht `seltsame` Resultate erzeugen, falls Bilder verwendet
werden, deren Gr
en nicht den Skalierungs-Vorgaben entsprechen.
Beispiel: Man benutzt einen Scale-Wert von 0.5 and die gleichen
          Bilder wie vorher. In diesem Fall werden alle gr
enabh
ngigen
          Werte durch 2 dividiert. Wenn z.B. ein 3D Operator verwendet
          wird, wird ein camZ-Wert vonn -800 auf -400 reduziert.
          Falls das Bild z.B. 640x480 Pixel gro
 ist, wird das
          Ergebnis sehr seltsam aussehen. Das Programm k
nnte sogar
          Schwierigkeiten bei der Berechnung bekommen, weil es fast
          unendlich gro
chen berechnen m
Vergessen Sie also nicht, auch den Eingabe-Stream entsprechend zu
ndern.
@endnode
@node ProcessorPreview
@{b}Vorschau (Preview-Window)@{ub}
Der Preview ist ein geeignetes Mittel, um komplizierte Scripts zu testen.
Es berechnet die Effekte des derzeitigen Prozessor-Scriptes unter
Zuhilfenahme einer kleinen Version des im @{" SinglePicture-Fenster " link PCSinglePictureWindow} angegebenen
Bildes.
Die Auswirkung der Ver
nderung von Parametern kann man sofort (auf schnellen
Rechnern) erkennen.
Die Breite und die Tiefe der Vorschau k
nnen im @{" SinglePicture-Fenster " link PCSinglePictureWindow}
eingestellt werden.
Die Breite von 160 Pixeln und die Tiefe 4 sind akzeptable Werte.
Die Original-Gr
e des Eingabebildes wird im Fenstertitel gezeigt.
Dies hilft beim verstellen der Parameter.
Wenn Sie bisher ein "normales" Bildbearbeitungsprogramm verwendet haben,
benutzten Sie sicherlich die grafische Oberfl
chew, z.B. malten Sie
ein Rechteck f
r einen Crop-Befehl. Dies ist nat
rlich auch in Wildfire
glich.
Im @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow} haben Sie die M
glichkeit,
mittels eines Kreises, Punktes oder Rechtecks direkt auf dem Preview-
Fenster einstellungen zu treffen und diese dann in einige Effekte zu
bernehmen.
@{b}Tastaturk
rzel:@{ub}
<Leertaste>   Zeichnen des Vorschau-Bildes
<c>
ffnen des @{" Bild Koordinaten-Fenster " link ImageCoordinatesWindow}
@endnode
@node ImageCoordinatesWindow
@{b}Bild-Koordinaten-Fenster (ImageCoordinatesWindow)@{ub}
Das Bild-Koordinaten-Fenster zeigt einige Informationen
das derzeit als Eingabe im EinzelBild-Fenster angew
hlte Bild
und gibt Ihnen die M
glichkeit, Effekt Parameter mittels einer graphischen
Benutzeroberfl
che zu bestimmen.
Es gibt verschieden Einstellungsm
glichkeiten:
@{b}Funktionen@{ub}
Kontroll-Art:
   Punkt    (point)    : einfacher Punkt, z.B. obere Ecke eines Bildes
   Rechteck (rect)     : z.B. rechteckiger Bereich, der mittels "Crop"
                         ausgeschnitten werden soll
   Kreis    (circle)   : z.B. St
rke und Radius eines Twirl Effekts
Links, Oben (Left,Top) - Koordinaten des Punktes (Bezogen auf das nicht
                         skalierte Eingabe-Bild
                       - obere linke Ecke des Rechtecks
                       - Zentrum des Kreises
Rechts, Unten (Right, Bottom)
                       - untere rechte Ecke des Rechtecks
Winkel      (Angle)    - Winkel des derzeitigen gezeichneten Radius
Radius      (Radius)   - Radius des Kreises
bernehmen  (Apply)    -
bernahme der Einstellungen in den derzeitig
                         ausgew
hlten Effekt
@{b}Zur Zeit unterst
tzte PlugIns@{ub}
   BlackHole   (point, circle)
   BGradient   (point, circle)
   Circle      (point, circle)
   ColorRegion (point, circle)
   Crop        (rect)
   Magnet      (point, circle)
   Rectangle   (rect)
   Rotate      (point, circle)
   RotateBlur  (point, circle)
   Twirl       (point, circle)
@{b}Hinweise@{ub}
1) Um einen Bereich f
r einen Crop-Befehl einzustellen, mu
 dieser
   deaktiviert werden (Taste <n>), bevor das Vorschau-Fenster ge
ffnet
   wird, da ansonsten der Befehl schon wirkt und einen Bereich aus
   dem Preview herausschneidet.
   Dies ist kein Fehler sondern die strikte Einhaltung des
   Vorschau-Konzeptes
2) Mit Hilfe dieses Fensters kann man auch Farben ausw
hlen.
   Wenn der Type "Punkt" (point) benutzt wird, werden die Farben
ber denen sich der Punkt befindet als RGB-Werte angezeigt
3) Graphisch eingestellte Parameter haben eine h
here Priorit
t als
   die normalen Parametereinstellungen. So macht es keinen Sinn,
   das Bild-Koordinaten-Fenster ge
ffnet zu haben und gleichzeitig
   die Parameter
ber das @{" Parameter-Einstellungs " link ParameterSettings}-Fenster
   zu ver
ndern.
@endnode
@node PCSinglePictureWindow
@{b}Einzelbild-Fenster (SinglePicture-Window)@{ub}
In diesem Fenster k
nnen Sie Einzelbilder bearbeiten und komplizierte
Prozessor-Skripte testen.
@{b}Funktionen:@{ub}
Input              Eingabe-Bild, als Vorgabe ist das Intro-Bild von
                   Wildfire eingestellt
Info               zeigt Informationen
ber das gew
hlte Eingabebild
Show               zeigt das gew
hlte Eingabebild an
Frame              die derzeitige Bild-Nummer (f
r Prozessor-Skripts)
Frames             Anzahl der Bilder, dieser Wert wird nur als Maximum
                   f
r den Frames-Slider benutzt
Scrollbar          zum Ver
ndern der Bildnummer (Frame)
Test Process       f
hrt das derzeitige Prozessor-Skript aus unter
                   Verwendung der eingestellten Bild-Nummer
Screenmode         Auswahl des Bildschirmmodes, auf dem das Ergebnis des
                   "Test Process" angezeigt wird
Apply Dimensions   Dimensions-
bergabe. Die Dimensionen des derzeitigen
                   Bildes werden an den ausgew
hlten Effekt
bergeben.
                   Ist z.B. ein Twirl-Effekt angew
hlt, wird das Zentrum
                   und der Radius beim Effekt richtig eingestellt
Preview            An/Ausschalten des @{" Preview " link ProcessorPreview}
Width              Breite des Previews
Depth              Tiefe des Previews, wenn die Tiefe gr
er ist als die
                   des derzeitigen Screens, wird automatisch umgeschaltet
Output             Ausgabe-Bild
Info               zeigt Informationen
ber das gew
hlte Ausgabebild
Show               zeigt das gew
hlte Ausgabebild an
Save Image         F
hrt das derzeitige Prozessor-Skript aus unter
                   Verwendung der eingestellten Bildnummer aus und
                   speichert das Ergebnis mit dem Speicherplugin, das
                   im @{" Savers-Fenster " link SaversWindow} gew
hlt werden kann, ab
Save Rendered      F
hrt das derzeitige Prozessor-Skript aus unter
                   Verwendung der eingestellten Bildnummer, rendert das
                   Bild mit den im Prozessor getroffenen Einstellungen
                   und speichert es als ILBM-Bild
@{b}Weitere Tastaturk
rzel:@{ub}
 <v>               An/Ausschalten des @{" Preview " link ProcessorPreview}
 <Leertaste>       Testen des Processes
 <left>,<right>    erh
hen/verringern der Bild-Nummer
Die Tastaturk
rzel <v>- und <Leertaste> sind auch innerhalb des
Effekt-Fensters und des Prozessor-Fensters g
ltig!
@endnode
@node StoryBoardWindow
@{b}StoryBoard-Fenster (StoryBoard-Window)@{ub}
In diesm Fenster kann das derzeitige Prozessor-Skript grafisch
dargestellt werden. Dies wird Ihnen helfen, die (vielleicht komplizierten)
Beispielscripts besser zu verstehen und es ist sehr hilfreich, um
eigene Skripts zu `debuggen`
Jede Zeile des Skripts wird durch 13 Thumbnails dargestellt:
 1 Stream-Puffer
 8 Temp-Puffer
 4 3D-Temp-Puffer
Leere Puffer bleiben auch in der Darstellung leer. 3D-Puffer k
nicht als `flache Bilder` dargetsllt werden, sie werden lediglich durch
den Text "3D-Buffer" gekennzeichnet.
@{b}Funktionen:@{ub}
Width               Breite der generierten Thumbnails
Colors              Palette, die zum Rendern benutzt wird
Frame               das Bild, welches dargestellt werden soll
Update              Berechnen und anzeigen der Thumbnails
Nach dem Abbrechen oder falls ein Fehler auftritt werden alle
bis zu diesem Zeitpunkt berechneten Bilder angezeigt. Somit kann
man leichter Fehler (wie z.B. nicht initialisierte Puffer) finden.
@endnode
@node VariablesWindow
@{b}Variablen-Fenster (Variables-Window)@{ub}
In diesem Fenster kann man die zeitabh
ngigen Animations-Parameter
erstellen, modifizieren, laden und speichern.
@{b}Funktionen:@{ub}
Add                 Hinzuf
gen einer Variable
Kill                L
schen der ausgew
hlten Variable
Rename
ndern des Namens der ausgew
hlten Variable
Envelope
ffnen des @{" Envelope-Fensters " link EnvelopeWindow} um die ausgew
                    Variable graphisch zu editieren
Expression          Angabe eines Ausdrucks, der beim Rendern der Animation
                    berechnet wird
File                Filename zum Laden/Speichern von Variablen
Load                Laden eines Variablen-Sets
Save                Speichern aller Variablen
Clear               L
schen der Variablen
@{b}Variablen-Typen@{ub}
Eine Variable kann entweder den Type "Envelop" oder den Type "Expression"
besitzen.
Wenn man etwas in das "Expression" Gadget eingibt, wird der Typ
automatisch gew
hlt. Mittels der "Expression" kann man sehr einfach
Skripts erzeugen, die v
llig unabh
ngig von den Bild-dimensionen sind.
Dies ist ein sehr m
chtiges Werkzeug.
Die folgenden Symbole sind vorgegeben:
 pcWidth, - Bild-dimensionen welche durch das @{" GetDimensions " link opGetDimensions}-PlugIn
 pcHeight   eingestellt werden
 pcFrame  - derzeitige Bildnummer
 pcXMin,  - (echte) `bounding-box` von Objekten beim @{" DataPlot " link opDataPlot}-,
 pcXMax,    @{" LWOB " link opLWOB}-, @{" ParPlot " link opParPlot}- und @{" ZPlot " link opZPlot}-PlugIn
 pcYMin,
 pcYMax,
 pcZMin,
 pcZMax
@{b}Beispiel: Zusammenf
gen zweier Bilder (unbekannter Gr
e) horizontal@{ub}
 1. *Hinzuf
gen einer Variable     "width"
    *Eingabe der Expression        "1*pcWidth"
    *Hinzuf
gen einer Variable     "2*width"
    *Eingabe der Expression        "2*pcWidth"
    *Hinzuf
gen einer Variable     "height"
    *EIngabe der Expression        "pcHeight"
 2. Laden des ersten Bildes in TEMP1 mittels dem LoadImage-PlugIn
 3. Import der Dimensionen mittels des GetDimensions-PlugIn
 4. Erstellung eines schwarzen Hintergrundes mittels der Variablen
    "2*width" and "height" unter Verwendung des CreateImage-PlugIn
 5. Compose des ersten Bildes mit dem Compose-PlugIn
    (left=0, back=dest=STREAM, fore=TEMP1)
 6. Laden des 2. Bildes in TEMP1
 7. Compose des 2. Bildes mit dem Compose-PlugIn
    (left=width, back=dest=STREAM, fore=TEMP1)
Dies mag auf den ersten Blick etwas kompliziert erscheinen, aber man
kann mittels dieses Skriptes z.B. sehr n
tzliche Makros erstellen, in
dem man es ein wenig erweitert. (z.B. ein Makro zum composen von
3x2 Bildern...)
@{b}Weitere Hinweise@{ub}
Nach dem L
schen einer Variable sind alle Informationen dar
verloren - auch die in dem Prozessor-Skript.
Eine sehr oft Benutzte ansteigende Gerade kann sehr leicht mittels
der "Expression"  "pcFrame/frames*endValue" erzeugt werden, z.B.
"pcFrame/60*360" f
r eine Rotation mit dem Winkel 0 bis 360 Grad
innerhalb von 60 Bildern.
@endnode
@node SaversWindow
@{b}Speicherer-Fenster (Savers-Window)@{ub}
Hier kann man das Speicherformat f
r die Truecolor-Bilder w
hlen.
Die meisten "Saver" haben ein Einstellungsfenster, welches auch aus
diesem Fenster heraus aufgerufen werden kann.
Weiterhin kann man "Saver"-Plugins hinzuf
gen oder aus dem Speicher
schen. Da die "Saver" auch die "Loader" Funktionen enthalten,
kann man - wenn man die "Saver" aus dem Speicher entfernt hat -
auch nicht mehr Bilder der entsprechenden Formate laden.
Alle unbekannten Fileformate werden versucht
ber Datatypes angesprochen
zu werden. Dies beschr
nkt sich nur auf das Laden.
Man kann die "Loader" Funktion von Wildfires "Savern" explizit
abschalten, falls sie z.B. nicht alle Formate (png hat sehr viele
Unterformate) unterst
tzt und man lieber die Datatypes benutzen m
chte.
Es gibt viele Anwender die sagen "Mein Datatype ist der sch
nste, der
beste und der schnellste" Falls Sie auch dazugeh
ren, k
nnen Sie
die Einstellungen der Saver auch abspeichern, nachdem Sie den Loader
ausgeschaltet haben. Diese Einstellung bleibt danach auch erhalten.
(Es ist aber nicht einfach, einen schnelleren Datatype.Loader zu
 schreiben, als Wildfire`s interner Loader, da das Program seit Beginn
 auf Geschwindigkeit getrimmt wurde, und nicht auf geringen Speicher-
 verbrauch)
@{b}Funktionen:@{ub}
Add            Hinzuf
gen eines externen Saver-PlugIns
Delete         L
schen des ausgew
hlten Saver-PlugIns
SavePrefs      Speichern der Optionen des ausgew
hlten PlugIns
Options
ffnen des Optionen-Fenster des ausgew
hlten Saver-PlugIns
@{b}Available Savers@{ub}
 @{" ILBM     " link svILBM}
 @{" EPS      " link svEPS}
 @{" JPEG     " link svJPEG}
 @{" PNG      " link svPNG}
 @{" PPM      " link svPPM}
 @{" ADProGIF " link svADProGIF}
@endnode
@node svILBM
@{b}ILBM-Saver@{ub}
Dieses Plugin liest und schreibt das ILBM-Format.
@{b}Optionen (Options):@{ub}
Compression     ByteRun1/None
Loader          an/ausschalten des Loaders
Falls Sie sehr gro
e Bilder (z.B. 600 dpi) speichern wollen, k
Sie die `no Compression` Funktion w
hlen. Dies spart einiges
an Arbeitsspeicher, falls dieser nicht ausreicht, um das Bild zu packen!
@endnode
@node svEPS
@{b}EPS-Saver@{ub}
Dieses PlugIn enth
lt einen Saver f
r ungepackte EPS-Bilder
@{b}Optionen (Options):@{ub}
 Resolution    Aufl
sung in dpi (dots per inch)
 Type        Ausgabe-Type: Gray (Grau), Color (Farbe) oder
                              Black&White (Schwarz/Wei
Die generierten Files sind nicht komprimiert und somit
leicht portierbar. Falls Sie z.B. Ihr TeX Dokument mit
Bildern dieses Typs illustrieren, k
nnen Sie sie unter
Verwendung aller m
glichen Postscript-Anzeiger/Drucker
auf jeder Plattform anzeigen bzw. drucken.
@endnode
@node svJPEG
@{b}JPEG-Saver@{ub}
Dieses Plugin l
dt und speichert Bilder im JPEG Format
@{b}Optionen (Options):@{ub}
Quality         verbleibende Bildqualit
t in Prozent
Format          an/ausschalten des Normal/Progressive-Formats
Optimize        an/ausschalten der Huffman-Tabellen-Optimierung
Output          an/ausschalten der TrueColor/GrayScale-Ausgabe
Loader          an/ausschalten des Loaders
In den meisten F
llen ist das TrueColor-Progressive-Format
die beste Wahl.
Dieses Plugin benutzt Routinen der @{b}IJG JPEG Library@{ub}
entwickelt von @{b}The Independent JPEG Group.@{ub}
@endnode
@node svPNG
@{b}PNG-Saver@{ub}
Dieses Plugin l
dt und speichert Bilder im PNG-Format
@{b}Optionen (Options):@{ub}
Format          verschiedene Formate sind unterst
                 24Bit RGB   : TrueColor-Bilder
                  8Bit Color : Gerenderte Bilder in 256 Farben
                               (Guter GIF-Ersatz)
                  8Bit Gray  : Grayscale-Bilder (Graustufen)
                  4Bit color : Gerenderte Bilder in 16 Farben
                  Black&White: Gerenderte Grayscale Bilder in 2 Farben
Loader          an/ausschalten des Loaders
Dieses PlugIn benutzt Routinen der @{b}PNG Reference Library@{ub}
entwickelt von @{b}Group 42, Inc.@{ub}
@endnode
@node svPPM
@{b}PPM-Saver@{ub}
Dieses PlugIn l
dt und speichert Bilder im PPM-Format. Alle Typen
1-6 (mit 8 Bits pro Pixel) werden unterst
@{b}Optionen (Options):@{ub}
Type            Bild-Type:
                  PPM   : Truecolor
                  PGM   : Grayscale (Graustufen)
                  PBM   : Black and White (Schwarz/Wei
Format          File-Format:
                  Raw   : Binary (kurze Files)
                  ASCII : Text-Zeichen (lange files)
Loader          an/ausschalten des Loaders
@endnode
@node svADProGIF
@{b}ADPro-GIF-Saver@{ub}
Dieses PlugIn benutzt ADPro um Bilder im GIF-Format zu speichern.
@{b}Optionen (Options):@{ub}
 ADPro   : Befehlszeile, die ausgef
hrt wird, falls ADPro nicht l
           wenn der Saver benutzt wird.
           Die Vorgabe ist:  "adpro:ADPro mm=1000000"
 Depth   : Bild Tiefe (1...8)
 Dither  : an/ausschalten des Ditherings
 Palette : Dynamische oder feste Palette
@{b}Hinweise:@{ub}
1) Dithering sollte man bei geringen Farbtiefen immmer anschalten
2) Um eine Bildsequence mit der gleichen (locked) Palette zu speichern
   mu
 zuerst das erste Bild mit der "Palette=Unlocked" Option gespeichert
   werden und danach die Palette festgesetzt werden
   Ansonsten wird eine "zuf
llig" Palette benutzt
3) In Kombination mit dem @{" ConvertImages " link ConvertImagesPlugIn}-PlugIn
   ist dieser Saver sehr n
tzlich, um HTML-Seiten zu verbessern (Gif-Anims!)
   (Zur Sicherheit nochmal: Vergessen Sie nicht die Palette beim ersten Bild
    einzustellen, wenn Sie Bild-Sequencen mit der gleichen Palette speichern
    wollen!)
@endnode
@node PaletteWindow
@{b}Farben-Fenster (Palette-window)@{ub}
Im Farben-Fenster k
nnen Sie eine feste Palette erstellen,
ndern, laden und speichern. Diese feste Palette kann vom
Processor zum rendern benutzt werden.
@{b}Funktionen:@{ub}
File              File zum laden/speichern der Palette
Load              Laden der Palette
Save              Speichern der Palette
Red, Green, Blue  Werte des ausgew
hlten Eintrags
Copy              Duplizieren der ausgew
hlten Farbe
Exchange          Vertauschen zweier Farben
Spread            Erzeugen eines Farbverlaufs
Undo              Zur
cksetzen der letzten ver
nderten Farbe auf ihren
                  alten Wert
State             an/ausschalten der festen Palette
Use
bernahme alle Ver
nderungen
Cancel            L
schen aller Ver
nderungen
Wenn die Palette angeschaltet (State Enabled) wird sie f
r alle
kommenden Render-Prozesse benutzt. Dies ist sehr wichtig, falls
Sie Animationen mit fester Palette unter Verwendung des Prozessors
erzeugen wollen.
Wenn Sie eine kleinere Farbtiefe des Bildschirms als 8 verwenden,
sind keine
nderungen der Palette (
nderungen der Bildschirmfarben)
erkennbar.
Anderenfalls k
nnen Sie durch das dr
cken der rechten Maustaste erreichen,
 die normalen Bildschirmfarben als untere Farben der Palette benutzt
werden, um die Gadgets besser erkennen zu k
nnen.
@endnode
@node CalculatorWindow
@{b}Taschenrechner-Fenster (Calculator-window)@{ub}
Diese Funktion wurde bereitgestellt, um leicht mathematische Ausdr
zu berechnen und um Benutzerdefinierte Symbole zu definieren oder
anzusehen.
Die Symble, die in diesem Fenster erstellt werden, k
nnen auch in
vielen anderen Gadgets von Wildfire benutzt werden.
@{b}Funktionen:@{ub}
1st string-gadget      Ausdruck, der berechnet werden soll
Results                Anzeige der letzten 3 Resultate
Symbols                Liste aller Benutzerdefinierten Symbole, speziell
                       Konstanten
Load                   Laden der Symbolde etc.
Save                   SPeichern der Symbole und sontiger Eingaben
Evaluate
ffnen des @{" Evaluate-Fenster " link EvaluateWindow}
Um ein Symbol zu definieren geben Sie seinen Namen ein und (wahlweise)
seinen Wert.
z.B erstellt die Eingabe "a=sqrt(9)/2" die Variable "a", die den Wert
1.5 besitzt. Sp
ter kann sie dann z.B. in Prozessor-Gadgets eingegeben
werden. Wenn das Gadget vom Type Float ist (z.B. Zoom-Faktor), dann
wird dort 0.75 verwendet, ansonsten wird auf 1 aufgerundet.
@endnode
@node EvaluateWindow
@{b}Evaluate-Fenster@{ub}
Hier k
nnen Sie einfach Datenfiles berechnen.
@{b}Funktionen:@{ub}
Filename               Filename des zu generierenden Files
Expression             Ausdruck, der berechnet werden soll
XMin                   X-Start-Wert
XMax                   X-End-Wert
XStep                  X-Erh
Evaluate               Start der Berechnung
View                   Anzeige des Resultates mit dem voreingestellten
                       Textanzeiger
Wenn der "XStep" Wert negativ ist, k
nnen Sie einen Start Wert verwenden,
der gr
er als der End Wert ist.
Alle Berechnungen werden mit doppelter Genauigkeit durchgef
@endnode
@node EnvelopeWindow
@{b}Envelope-Fenster (Envelope Window)@{ub}
In diesem Fenster werden alle zeitabh
ngigen Animationsparameter
(genannt "Envelopes") erstellt und ver
ndert.
Ein Envelope ist eine zweidimensionale Kurve, die graphisch oder
unter Verwendung numerischer Ausdr
cke, die beim Rendern berechnet
werden, bestimmt werden kann.
Die X-Koordinate dieser zweidimensionalen Kurven stellt die Bild-Nummer
dar (also den Zeitverlauf), der Wert des Animationsparameters beim
Bild X ist der entsprechende Wert Y.
(Numerische Ausr
cke werden im @{" Variables-Fenster " link VariablesWindow} vorgegeben)
Wenn die Bild-Nummer im Prozessor gr
er oder kleiner dem Bereich
ist, der graphisch festgelegt ist, wird der erste oder der letzte
Y-Wert f
r alle folgenden Bilder verwendet.
Wenn der Envelope z.B. nur einen einzigen Punkt enth
lt, wird
dieser Y-Wert f
r die ganze Animation benutzt.
Die meisten Operationen k
nnen mit der Maus vorgenommen werden.
Man kann einen Punkt ausw
hlen, indem man auf ihn klickt, wenn
man auf den Punkt klickt und die linke Maustaste h
lt, kann man
den Punkt mit der Maus bewegen.
Dar komplette Graph kann mit den Cursortasten gescrollt werden.
@{b}Funktionen:@{ub}
XRange            der angezeigte X-Bereich
YRange            der angezeigte Y-Bereich
X                 der X-Wert (Bild-Nummer) des ausgew
hlten Punktes
Y                 der Y-Wert des ausgew
hlten Punktes
Add Point         Hinzuf
gen eines Punktes
Kill Point        L
schen eines Punktes
Type              Ver
ndern des Types des Envelopes:
                   Linear: Verbindung zweier Punkte mittels gerader Linie
                   Spline: Verwendung Kubischer Interpolation um die
                           Punkte zu verbinden
                   Bezier: Umschlie
t Punkte mit einer Bezier-Kurve
View All          Anzeigen des kompletten Envelopes
File              Filename zum laden/speichern des Envelopes
Load              Laden eines Envelopes
Save              Speichern des Envelopes
Use               Verwendung aller Ver
nderungen
Cancel            L
schen aller
nderungen
Advanced Options
ffnen des @{" EnvelopeAdvanced-Fenster " link EnvelopeAdvancedWindow} um
                  komplexere Operationen durchzuf
@{b}Weitere Tastaturk
rzel:@{ub}
<t>               Sortiert alle Punkte (von Envelopes, die aus alten
                  Process-Files importiert wurden)
@endnode
@node EnvelopeAdvancedWindow
@{b}EnvelopeAdvanced-Fenster (EnvelopeAdvanced-window)@{ub}
In diesem Fenster kann man selten benutzte - aber dennoch sehr n
tzliche -
Transformationen f
r ENvelopes benutzen.
@{b}Funktionen:@{ub}
@{u}Point-Operations:@{uu}
First, Last, Step     Punkt-Bereich, der beeinflu
t wird
YValue                X-Wert, der bei der Transformation verwendet wird
YValue                X-Wert, der bei der Transformation verwendet wird
Scale                 Skaliert den Envelope mittels des X- und Y Wertes
Shift                 Verschiebt den Envelope mittels des X- und Y Wertes
@{u}Berechnung: (Evaluate Expression)@{uu}
XMin, XMax, XStep     X-Bereich, der f
r die Berechnung benutzt wird
Expression            Mathematischer Ausdruck in abh
ngigkeit von X
Evaluate              Erzeugung eines Envelopes unter verwendung des
                      X-Bereiches und der berechneten Y-Werte
@{u}Import/Export:@{uu}
Load Curve            Laden und Umwandeln eines 2D Datenfiles, welches
                      z.B. Plot-Programme benutzen, als Envelope
Save Curve            Speichern des ENvelopes als 2D Datenfiles
Load Timecodes        Laden eines Timecodefiles und konvertierung in
                      einen Envelope
Save Timecodes        Speichern des Envelopes im Timecode-Format, er kann
                      dann im @{"Timecodes-Fenster" link TimecodesWindow} geladen werden
@endnode
@node PCAddWindow
@{b}Operators-Fenster@{ub}
Das Operator-Fenster
ffnet sich, nachdem man auf den "Add"-Knopf im
Prozessor-Fenster geklickt hat und erm
glicht es dem Anwender, einen
Operator auszuw
hlen, der dann ins Prozessor-Script eingef
gt wird.
Dieses Fenster kann komplett mit der Maus oder mit der Tastatur bedient
werden. Benutzen Sie die Cursor-Tasten um durch die Befehlsliste zu
scrollen und die <Enter> Taste, um den Effekt auszuw
hlen.
@{b}Funktionen:@{ub}
Select          Hinzuf
gen des ausgew
hlten Effektes in das Prozessor-
                Skript
Cancel          Auswahl abbrechen
@{b}Operator-PlugIns:@{ub}
Es existieren 5 Arten von Plugins, die man nach Ihrem Zweck
unterscheiden kann:
 @{b}Puffer:@{ub} Ver
ndern oder Erstellen von Puffern
   @{" AutoCrop        " link opAutoCrop       } L
schen von
eren Bereichen der selben Farbe
   @{" Compose         " link opCompose        }
berlagerung zweier Bilder                    @{" Beispiel " system "visage wf:doc/pictures/Compose.pic"}
   @{" CreateImage     " link opCreateImage    } Kreierung eines farbigen Bildes               @{" Beispiel " system "visage wf:doc/pictures/CreateImage.pic"}
   @{" Crop            " link opCrop           } Ausschneiden eines rechteckigen Bereiches aus einem Bild
   @{" DLA             " link opDLA            } Kreierung eines farbigen Effekt-Bildes        @{" Beispiel " system "visage wf:doc/pictures/DLA.pic"}
   @{" GSImport        " link opGSImport       } Import von PostscriptFiles durch ghostscript  @{" Beispiel " system "visage wf:doc/pictures/GSImport.pic"}
   @{" KillTemp        " link opKillTemp       } L
schen  eines TEMP-Puffers
   @{" LoadImage       " link opLoadImage      } Einladen eines Bildes
   @{" LoadTemp        " link opLoadTemp       } Kopieren eines TEMP-Puffers in den Stream
   @{" Plasma          " link opPlasma         } Kreierung eines farbigen Effekt-Bildes        @{" Beispiel " system "visage wf:doc/pictures/Plasma.pic"}
   @{" SaveImage       " link opSaveImage      } Speichern eines Bildes auf HD etc.
   @{" SaveTemp        " link opSaveTemp       } Kopieren des Streams in einen TEMP-Puffer
 @{b}2D-F/X:@{ub} Berechnung von 2-dimensionalen Transformationen
   @{" BlackHole       " link opBlackHole      } Deformation eines Bildes                      @{" Beispiel " system "visage wf:doc/pictures/BlackHole.pic"}
   @{" Bump            " link opBump           } Hinzuf
gen der 3. Dimension zu einem Bild     @{" Beispiel " system "visage wf:doc/pictures/Bump.pic"}
   @{" Cartesian2Polar " link opCartesian2Polar} Transformation der Koordinaten eines Bildes   @{" Beispiel " system "visage wf:doc/pictures/Cartesian2Polar.pic"}
   @{" Displace        " link opDisplace       } Zuf
lliges vertauschen der Pixel              @{" Beispiel " system "visage wf:doc/pictures/Displace.pic"}
   @{" Flip            " link opFlip           } Spiegelung eines Bildes an diversen Achsen    @{" Beispiel " system "visage wf:doc/pictures/Flip.pic"}
   @{" Halve           " link opHalve          } Schnelles halbieren der Gr
e eines Bildes
   @{" Magnet          " link opMagnet         } Deformation des Bildes                        @{" Beispiel " system "visage wf:doc/pictures/Magnet.pic"}
   @{" MotionBlur      " link opMotionBlur     } Bewegungs-Effekt wird einem Bild hinzugef
gt  @{" Beispiel " system "visage wf:doc/pictures/MotionBlur.pic"}
   @{" Pixelize        " link opPixelize       } Verringerung der Aufl
sung eines Bildes       @{" Beispiel " system "visage wf:doc/pictures/Pixelize.pic"}
   @{" Roll            " link opRoll           } Rollen des Bildes in verschiedene Richtungen  @{" Beispiel " system "visage wf:doc/pictures/Roll.pic"}
   @{" Rotate          " link opRotate         } Rotation (von Teilen) eines Bildes            @{" Beispiel " system "visage wf:doc/pictures/Rotate.pic"}
   @{" RotateBlur      " link opRotateBlur     } Rotation mit Bewegungs-Effekt                 @{" Beispiel " system "visage wf:doc/pictures/RotateBlur.pic"}
   @{" Scale           " link opScale          } Skalierung eines Bildes
   @{" Shear           " link opShear          } Sch
tteln des Bildes                          @{" Beispiel " system "visage wf:doc/pictures/Shear.pic"}
   @{" ShiftLines      " link opShiftLines     } Zuf
lliges verschieben von Linien des Bildes  @{" Beispiel " system "visage wf:doc/pictures/ShiftLines.pic"}
   @{" TileBrick       " link opTileBrick      } Vervielfacht ein (kleines) Bild (Pattern)     @{" Beispiel " system "visage wf:doc/pictures/TileBrick.pic"}
   @{" Twirl           " link opTwirl          } Deformation des Bildes                        @{" Beispiel " system "visage wf:doc/pictures/Twirl.pic"}
   @{" Wave            " link opWave           } Hinzuf
gen einer harmonischen 2D-Welle        @{" Beispiel " system "visage wf:doc/pictures/Wave.pic"}
   @{" Wind            " link opWind           } Simulation von Wind                           @{" Beispiel " system "visage wf:doc/pictures/Wind.pic"}
 @{b}Color:@{ub}  Farbvariationen
   @{" Add             " link opAdd            } Addieren zweier Bilder                        @{" Beispiel " system "visage wf:doc/pictures/Add.pic"}
   @{" Alpha           " link opAlpha          } Farbver
nderungen mittels Alpha-Kanal         @{" Beispiel " system "visage wf:doc/pictures/Alpha.pic"}
   @{" Antique         " link opAntique        } Ver
nderung der Farben um "Antique" zu wirken @{" Beispiel " system "visage wf:doc/pictures/Antique.pic"}
   @{" Balancing       " link opBalancing      } Ver
nderung der Bildfarben                    @{" Beispiel " system "visage wf:doc/pictures/Balancing.pic"}
   @{" BGradient       " link opBGradient      } Ver
nderung der Farben mittels Gradienten     @{" Beispiel " system "visage wf:doc/pictures/BGradient.pic"}
   @{" ColorRegion     " link opColorRegion    } L
schen eines Bereiches mit
hnlichen Farben  @{" Beispiel " system "visage wf:doc/pictures/ColorRegion.pic"}
   @{" ColorToGray     " link opColorToGray    } Konvertierung eines Bildes in Graustufen      @{" Beispiel " system "visage wf:doc/pictures/ColorToGray.pic"}
   @{" Convolve        " link opConvolve       } Hinzuf
gen eines Convolution-Filters          @{" Beispiel " system "visage wf:doc/pictures/Convolve.pic"}
   @{" EdgeDetect      " link opEdgeDetect     } Fortschrittliche Kanten-Erkennung             @{" Beispiel " system "visage wf:doc/pictures/EdgeDetect.pic"}
   @{" Emboss          " link opEmboss         } Ver
nderung des Bildes als ob es aus Stein sei@{" Beispiel " system "visage wf:doc/pictures/Emboss.pic"}
   @{" LineArt         " link opLineArt        } Kreierung eines Linen-Effektes                @{" Beispiel " system "visage wf:doc/pictures/LineArt.pic"}
   @{" LUT             " link opLUT            } Farb
nderung mittels einer Farbtabelle        @{" Beispiel " system "visage wf:doc/pictures/LUT.pic"}
   @{" MedianFilter    " link opMedianFilter   } Hinzuf
gen eines Medianfilters
   @{" Negative        " link opNegative       } Helle Fl
chen werden dunkel - und umgekehrt   @{" Beispiel " system "visage wf:doc/pictures/Negative.pic"}
   @{" Neon            " link opNeon           } Hinzuf
gen eines Neon-Schimmerns              @{" Beispiel " system "visage wf:doc/pictures/Neon.pic"}
   @{" Noise           " link opNoise          } Zuf
llige Verrauschungen werden berechnet     @{" Beispiel " system "visage wf:doc/pictures/Noise.pic"}
   @{" OilTransfer     " link opOilTransfer    } Umwandlung des Bildes in ein
lde        @{" Beispiel " system "visage wf:doc/pictures/OilTransfer.pic"}
   @{" Posterise       " link opPosterise      } Reduzierung der Farbinformationen             @{" Beispiel " system "visage wf:doc/pictures/Posterise.pic"}
   @{" ReplaceComp     " link opReplaceComp    } Austauschen eines Farbkanals                  @{" Beispiel " system "visage wf:doc/pictures/ReplaceComp.pic"}
   @{" RIP             " link opRIP            } Entfernung von isolierten Pixeln
   @{" SwapRGB         " link opSwapRGB        } Tauschen der Farbkomponenten eines Bildes     @{" Beispiel " system "visage wf:doc/pictures/SwapRGB.pic"}
   @{" Threshold       " link opThreshold      } Erzeugung eines Alpha Kanals                  @{" Beispiel " system "visage wf:doc/pictures/Threshold.pic"}
 @{b}3D-F/X:@{ub}   Berechnung von komplexen 3-dimensionalen Effekten f
                    Bilder und 3D-Puffer
   @{" Axis3D          " link opAxis3D         } Hinzuf
gen von Achsen in sehr hoher Qualit
t  @{" Beispiel " system "visage wf:doc/pictures/Axis3D.pic"}
   @{" Bump3D          " link opBump3D         } Echtes Bump-mapping                           @{" Beispiel " system "visage wf:doc/pictures/Bump3D.pic"}
   @{" ColorCube       " link opColorCube      } 3D Farbraum und Alpha-Kanal                   @{" Beispiel " system "visage wf:doc/pictures/ColorCube.pic"}
   @{" Cube            " link opCube           } Ein Bild wird auf einen W
rfel gelegt         @{" Beispiel " system "visage wf:doc/pictures/Cube.pic"}
   @{" DataPlot        " link opDataPlot       } Zeichnen von 3Dimensionalen Datens
tzen       @{" Beispiel " system "visage wf:doc/pictures/DataPlot.pic"}
   @{" Genlock3D       " link opGenlock3D      } Dreidimensionales Genlock                     @{" Beispiel " system "visage wf:doc/pictures/Genlock3D.pic"}
   @{" Join3D          " link opJoin3D         } Verkn
pfung zweier 3D-Temp-Puffer             @{" Beispiel " system "visage wf:doc/pictures/Join3D.pic"}
   @{" KillTemp3D      " link opKillTemp3D     } L
schen eines 3D-Temp-Puffers
   @{" LWOB            " link opLWOB           } Laden und berechnen eines Lightwave-Objekts   @{" Beispiel " system "visage wf:doc/pictures/LWOB.pic"}
   @{" Magnet3D        " link opMagnet3D       } Greifen und bewegen von Bildteilen            @{" Beispiel " system "visage wf:doc/pictures/Magnet3D.pic"}
   @{" Morph           " link opMorph          } Interpolation zwischen zwei Objekten          @{" Beispiel " system "visage wf:doc/pictures/Morph.pic"}
   @{" ParPlot         " link opParPlot        } Zeichnen 3-dim. parametrischer Funktionen     @{" Beispiel " system "visage wf:doc/pictures/ParPlot.pic"}
   @{" Perspective     " link opPerspective    } Hinzuf
gen von Perspective zu einem Bild      @{" Beispiel " system "visage wf:doc/pictures/Perspective.pic"}
   @{" SetColor        " link opSetColor       } Ver
nderung der Objektfarben                  @{" Beispiel " system "visage wf:doc/pictures/SetColor.pic"}
   @{" Sphere          " link opSphere         } Ein Bild wird auf eine Kugel gelegt           @{" Beispiel " system "visage wf:doc/pictures/Sphere.pic"}
   @{" Transform3D     " link opTransform3D    } Berechnung von 3D-Transformationen            @{" Beispiel " system "visage wf:doc/pictures/Transform3D.pic"}
   @{" Triangulate     " link opTriangulate    } Umwandlung von Bildern in Phong-Objekte       @{" Beispiel " system "visage wf:doc/pictures/Triangulate.pic"}
   @{" Twirl3D         " link opTwirl3D        } Hinzuf
gen eines Twirls l
ngs jeder Achse     @{" Beispiel " system "visage wf:doc/pictures/Twirl3D.pic"}
   @{" Twist           " link opTwist          } Deformation eines Bildes mittels Rotation     @{" Beispiel " system "visage wf:doc/pictures/Twist.pic"}
   @{" Water           " link opWater          } Hinzuf
gen einer unharmonischen Wasserwelle   @{" Beispiel " system "visage wf:doc/pictures/Water.pic"}
   @{" Wave3D          " link opWave3D         } Hinzuf
gen einer harmonischen Welle           @{" Beispiel " system "visage wf:doc/pictures/Wave3D.pic"}
   @{" Wrap            " link opWrap           } Das Bild wird auf eine Kugel/Zylinder gelegt  @{" Beispiel " system "visage wf:doc/pictures/Wrap.pic"}
   @{" ZPlot           " link opZPlot          } Zeichnen von dreidimensionalen Funktionen     @{" Beispiel " system "visage wf:doc/pictures/ZPlot.pic"}
 @{b}Misc:@{ub}     Spezielle oder selten benutzte PlugIns
   @{" ARexx           " link opARexx          } Austauschen von Bildern mit anderen Programmen
   @{" Circle          " link opCircle         } Zeichnen eines Kreises                        @{" Beispiel " system "visage wf:doc/pictures/Circle.pic"}
   @{" Comment         " link opComment        } Hinzuf
gen eines Kommentares zum Processor-Script
   @{" FieldRendering  " link opFieldRendering } Konvertierung von Bildern in "Fields"
   @{" GetDimensions   " link opGetDimensions  } Hinzuf
gen von Bild-Dimensionen zu Variablen
   @{" Raster          " link opRaster         }
berlagerung mit einem schwarzen Raster       @{" Beispiel " system "visage wf:doc/pictures/Raster.pic"}
   @{" Rectangle       " link opRectangle      } Zeichnen eines Rechtecks                      @{" Beispiel " system "visage wf:doc/pictures/Rectangle.pic"}
   @{" SetBackGround   " link opSetBackGround  }
ndern der Hintergrundfarbe
   @{" Text            " link opText           } Hinzuf
gen von Text in diversen Ausf
hrungen  @{" Beispiel " system "visage wf:doc/pictures/Text.pic"}
Hinweis: Wenn man auf einen der @{" Beispiel " system "visage wf:Motivation2.jpg"}-Kn
pfe dr
         wird @{" Visage " link Visage} gestartet um das zum Effet geh
rende Beispielbild
         anzuzeigen.
@{b}Operator-Parameter:@{ub}
Numerische Parameters (wie z.B. Dimensionen, Winkel, Farben) werden in den
@{" Parameter-Settings " link ParameterSettings}- und @{" Color-Settings " link ColorSettings}-Fenstern
ausgew
@endnode
@node opAdd
@{b}Add-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Add.pic"}
Dieser Operator addiert oder subtrahiert zwei Bilder.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer         Beschreibung
@{uu}
Input1      STREAM, TEMP1, ..., TEMP8     erster Eingabe Puffer
Input2      STREAM, TEMP1, ..., TEMP8     zweiter Eingabe Puffer
Output      STREAM, TEMP1, ..., TEMP8     Ziel-Puffer
Mode        ADD, SUBTRACT                 Addieren oder Subtrahieren
@endnode
@node opCompose
@{b}Compose-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Compose.pic"}
Dieser Operator
berlagert zwei Bilder unter der Verwendung verschiedener
Genlock-Methoden und eines m
glichen Alpha-Kanals.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer                 Beschreibung
@{uu}
Background  STREAM, TEMP1, ..., TEMP8        Hintergrundbild
Foreground  STREAM, TEMP1, ..., TEMP8        Vordergrundbild
Destination STREAM, TEMP1, ..., TEMP8        Ziel-Puffer
Alpha       NONE, STREAM, TEMP1, ..., TEMP8  Optionaler Alpha Puffer
Left        pixels                           Linke Kante des Vordergrundbild
Top         pixels                           Obere Kante des Vordergrundbild
Mix         0...100                          Transparenz des Vordergrundbild
CentreX     ON, OFF                          Zentrierung des Vordergrundes horizontal
CentreY     ON, OFF                          Zentrierung des Vordergrundes vertical
Red1,       0...255                          Genlock-Farbe 1
Green2,     0...255
Blue        0...255
Red2,       0...255                          Genlock-Farbe 2
Green2,     0...255
Blue2       0...255
Genlock                                      Type des genlock:
            NONE                              Kein Genlock
            SINGLE COLOR                      normales Genlock unter Verwendung
                                              der Farbe 1
            INRANGE                           erweitertes Genlock unter
                                              Verwendung aller Farben innerhalb
                                              des Bereiches Farbe1...Farbe2
            OUTRANGE                          erweitertes Genlock unter
                                              Verwendung aller Farben au
erhalb
                                              des Bereiches Farbe1...Farbe2
@endnode
@node opCreateImage
@{b}CreateImage-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/CreateImage.pic"}
Dieser Operator erzeugt ein Bild mit optionalem Farbverlauf.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Width       pixels                     Breite des generierten Bildes
Height      pixels                     H
he des generierten Bildes
Palette     (gadget)                   Auswahl einer der vier Ecken
Red,        0...255                    Farbe der gew
hlten Ecke
Green,      0...255
Blue        0...255
HCopy       (gadget)                   Kopieren der ausgew
hlten Farbe horizontal
VCopy       (gadget)                   Kopieren der ausgew
hlten Farbe vertikal
HVCopy      (gadget)                   Kopieren der ausgew
hlte Farbe in
                                       alle vier Ecken
@endnode
@node opNeon
@{b}Neon-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Neon.pic"}
Dieser Operator f
gt einen Neon Effekt zu einem Bild hinzu.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Red,        0...255                    Farbe des Bildteils
Green,      0...255                    der ver
ndert werden soll
Blue        0...255
Radius      pixels                     Radius des Effektes
Tolerance   0...1.0                    Farb-Tolerance
Intensity   0...1.0                    Intensit
Algorithm                              Zu benutzender Algorithmus
            TRIVIAL                    Algorithmus wie z.B. in DPaint
            HK-CLUSTER                 Verwendung des Hoshen-Kopelman-algorithmus [1]
                                       um Individuelle Cluster zu finden
[1] Phys. Rev.B14, 3428 (1976)
@endnode
@node opCrop
@{b}Crop-Operator@{ub}
Dieser Operator schneidet einen rechteckigen Bereich aus einem Bild aus.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8  Eingabe-Puffer
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Left        pixels                     Linke Kante des Rechtecks
Top         pixels                     Obere Kante des Rechtecks
Width       pixels                     Breite des Rechtecks
Height      pixels                     H
he des Rechtecks
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opAutoCrop
@{b}AutoCrop-Operator@{ub}
Dieser Operator entfernt au
en liegende Bereiche mit der selben Farbe.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8  Eingabe-Puffer
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
@endnode
@node opKillTemp
@{b}KillTemp-Operator@{ub}
Dieser Operator l
scht einen TEMP-Puffer und gibt seinen Speicher frei.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer     Beschreibung
@{uu}
Buffer      TEMP1, ... TEMP8     TEMP-Puffer der gel
scht werden soll
@endnode
@node opKillTemp3D
@{b}KillTemp3D-Operator@{ub}
Dieser Operator l
scht einen Temp3D Puffer und gibt seinen Speicher frei.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer     Beschreibung
@{uu}
Buffer      TEMP3D1, ... TEMP3D4      3d-Temp-Puffer der gel
scht werden soll
@endnode
@node opLoadImage
@{b}LoadImage-Operator@{ub}
Dieser Operator l
dt ein Bild oder eine Bildsequence ein.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Sequence    string                     Kompletter Filename eines Einzelbildes
                                       oder Base-Filename einer Bildsequence
Loop        integer                    L
nge der Bildsequence
Shift       integer                    Verschiebungswert beim hochz
Show        (gadget)                   Anzeigen des Bildes
@endnode
@node opLoadTemp
@{b}LoadTemp-Operator@{ub}
Dieser Operator l
dt einen Temp-Puffer in den Stream.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer        Beschreibung
@{uu}
Buffer      TEMP1, ... TEMP8        TEMP-Puffer in dem das Bild liegt,
                                    welches in den STREAM soll
@endnode
@node opPlasma
@{b}Plasma-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Plasma.pic"}
Dieser Operator erzeugt ein Bild mittels eines Fractal-Algorythmus
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Width       pixels                     Breite des generierten Bildes
Height      pixels                     H
he des generierten Bildes
Dimension   integer                    Fractal-Dimension, beeinflu
t die
                                       Feinheit des Fractals
Seed        integer                    Parameter der das Aussehen beeinflu
@endnode
@node opDLA
@{b}DLA-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/DLA.pic"}
Dieser Operator erzeugt ein Bild mittels des "diffusion limited
aggregation"-algorythmus [1].
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Width       pixels                     Breite des generierten Bildes
Height      pixels                     H
he des generierten Bildes
Iterations  integer                    Anzahl der Iterationen, beeinflu
                                       die Gr
e der erzeugten Cluster
Seed        integer                    Parameter der das Aussehen beeinflu
Red,        0...255                    Farbe des erzeugten Bildes
Green,      0...255
Blue        0...255
[1] T.A. Witten; L.M. Sander, Phys. Rev. Lett. 47, 1400 (1981)
@endnode
@node opReplaceComp
@{b}ReplaceComp-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ReplaceComp.pic"}
Dieser Operator entfernt einen Farbkanal und f
gt den Rot-Kanal eines
anderen Bildes an dessen Stelle ein.
Der Haupt-Zweck dieses PlugIns ist die Erzeugung von
Stereo-3D-Bildern.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input1      STREAM, TEMP1, ..., TEMP8  Eingabe-Puffer
Input2      STREAM, TEMP1, ..., TEMP8  Bild, welches den Kanal ersetzt
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
Component   RED, GREEN, BLUE           Farbkanal, der ersetzt werden soll
@endnode
@node opSaveImage
@{b}SaveImage-Operator@{ub}
Dieser Operator speichert Bilder auf die Harddisk.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8  Bild welches gespeichert werden soll
File        string                     Filename
Numbering   string                     C-Formatstring, wenn der String nicht
                                       leer ist, wird die derzeitige
                                       Bildnummer an den Filenamen angef
@endnode
@node opSaveTemp
@{b}SaveTemp-Operator@{ub}
Dieser Operator kopiert den Stream in einen TEMP-Puffer.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer       Beschreibung
@{uu}
Buffer      TEMP1, ... TEMP8       Puffer in den kopiert werden soll
@endnode
@node opBlackHole @{" Beispiel " system "visage wf:doc/pictures/BlackHole.pic"}
@{b}BlackHole-Operator@{ub}
Dieser Operator zieht das Bild zusammen
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8  Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
CentreX,    pixels                     Zentrum des Effekts
CentreY     pixels
Amount      pixels                     St
rke, bei gro
en Werten kann
                                       u.U. das ganze Bild verschwinden
Radius      pixels                     Parameter, der die Gr
e des
                                       Einflu
bereiches bestimmt
Zoom        -10.0...10.0               Zoom-Faktor f
r das Bild
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opCartesian2Polar
@{b}Cartesian2Polar-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Cartesian2Polar.pic"}
Dieser Operator wandelt die Kartesischen Bild-Koordinaten ind
Polar-Koordinaten um
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer         Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8     Eingabe-Puffer
Output      STREAM, TEMP1, ..., TEMP8     Ausgabe-Puffer
R0          pixels                        Startwert f
r den Radius
Phi0        degrees                       Startwert f
r den Winkel
Zoom        -10.0...10.0                  Zoom-Faktor f
r das Bild
@endnode
@node opDisplace
@{b}Displace-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Displace.pic"}
Dieser Operator vertauscht zuf
llig Bildpunkte
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Radius      pixels                          Gr
te Entfernung zwischen
                                            zwei Punkten, die vertauscht
                                            werden k
Probability 0...100                         Wahrscheinlichkeit der Vertauschung
                                            in Prozent
Seed        integer                         Startwert f
r den Zufallsgenerator
@endnode
@node opWind
@{b}Wind-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Wind.pic"}
Dieser Operator verwischt (blur) Pixel  mit einem hohen Kontrast (Kanten)
entlang gerader linien.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Direction   LEFT, RIGHT                     Richtung des Effekts
Intensity   pixels                          durchschnittliche Blur-L
Probability 0...100                         Blur-Wahrscheinlichkeit
Seed        integer                         Startwert f
r den
                                            Zufallsgenerator
@endnode
@node opFlip
@{b}Flip-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Flip.pic"}
Dieser Operator speigelt ein Bild an einer angegebenen Achse.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Axis        X, Y, XY                        Spiegel Achse
@endnode
@node opHalve
@{b}Halve-Operator@{ub}
Dieser Operator halbiert die Dimensionen eines Bildes
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opMagnet
@{b}Magnet-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Magnet.pic"}
Dieser Operator f
gt ein lokales Zusammenziehen oder eine lokale
Expansion zu einem Bild hinzu.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX     pixels                          Zentrum des Effekts
CentreY     pixels
Amount      pixels (about -20...20)         St
rke der Verformung, positive
                                            Werte f
hren zu einer Kontraktion,
                                            negative zu einer Expansion
Damping     float                           Parameter der das abschw
chen der
                                            Deformation regelt
Zoom        -10.0...10.0                    Zoom-Faktor f
r das Bild
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opMotionBlur
@{b}MotionBlur-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/MotionBlur.pic"}
Dieser Operator verleiht dem Bild den Eindruck einer Bewegung
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
DeltaX,     pixels                          Richtung und St
rke des Effekts
DeltaY      pixels
@endnode
@node opPixelize
@{b}Pixelize-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Pixelize.pic"}
Dieser Operator verringert die Aufl
sung eines Bildes indem Rechtecke
erzeugt werden.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Width       pixels                          Breite des erzeugten Rechtecks
Height      pixels                          H
he des erzeugten Rechtecks
Centre      ON, OFF                         Zentrieren des Rechtecks, dies
                                            sollte ausgeschaltet werden, falls
                                            die Gr
e des Rechtecks animiert
                                            wird
Grid        OFF, XY, X, Y                   Type des optionalen Rasters
Size        pixels                          Dicke des Rasters
Red,        0...255                         Basisfarbe des Rasters
Green,      0...255
Blue        0...255
DLeft,      0.0...1.0                       Farbver
nderung des Rasters um
DRight      0.0...1.0                       einen 3D Eindruck zu erzeugen
DTop        0.0...1.0                       Setzen Sie alle Werte auf Null
DBottom     0.0...1.0                       um ein `flaches` Raster zu erzeugen
@endnode
@node opTileBrick
@{b}TileBrick-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/TileBrick.pic"}
Dieser Operator vervielfacht ein (kleines) Bild, um z.B. Pattern f
einen Hintergrund oder einen Alpha-Kanal zu erzeugen.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Width,      pixels                          Dimensionen des erzeugten
Height                                      Pattern
Shift       pixels                          Offset zwischen den Reihen
@{b}Hinweise@{ub}
1)  Um ein "TileBrick" zu erzeugen beutzt man einen Shift-Wert
    von: ("Eingabe-Breite")/2.
@endnode
@node opRoll
@{b}Roll-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Roll.pic"}
Dieser Operator verschiebt ein Bild in verschiedene Richtungen
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
DeltaX,     pixels                          Verschiebungsrichtung und
DeltaY      pixels                          -Strecke
Wrap        ON, OFF                         an/ausschalten der
berlappung
@endnode
@node opRotate
@{b}Rotate-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Rotate.pic"}
Dieser Operator rotiert einen kreisf
rmigen Bereich eines Bildes
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX,    pixels                          Zentrum des Kreises
CentreY     pixels
Radius      pixels                          Radius des Kreises
Amount      degrees                         Rotationswinkel
Zoom        -10.0...10.0                    Zoom-Faktor f
r den rotierten
                                            Bereich
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opRotateBlur
@{b}RotateBlur-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/RotateBlur.pic"}
Dieser Operator f
gt dem Bild den Eindruck einer Kreisf
rmigen
Bewegung zu
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX,    pixels                          Zentrum des bewegten Kreises
CentreY     pixels
Radius      pixels                          Radius des Kreises
Amount      degrees                         blur-St
re, gro
e Werte wie
                                            z.B. 60 rufen eine SEHR lange
                                            Berechnungszeit hervor!
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opScale
@{b}Scale-Operator@{ub}
Dieser Operator vergr
ert oder verkleinert Bilder.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Width       pixels/percent                  Horizontale Gr
e des erzeugten
                                            Bildes
Height      pixels/percent                  Vertikale Gr
e des erzeugten
                                            Bildes
Type        PIXELS, PERCENT                 Auswahl, ob die Gr
en in Pixel
                                            oder in Prozent angegeben sind
Aspect                                      Auswahl, ob der Aspekt erhalten
                                            bleiben soll oder nicht
            IGNORE                           Bild wird auf die angegebenen
                                             Gr
en skaliert
            TAKEWIDTH                        Bild wird auf die angegebene
                                             Breite skaliert, die H
he wird
                                             berechnet, indem der Aspekt
                                             beibehalten wird
            TAKEHEIGHT                       Bild wird auf die angegebene
                                             H
he skaliert, die Dreite wird
                                             berechnet, indem der Aspekt
                                             beibehalten wird
@endnode
@node opShear
@{b}Shear-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Shear.pic"}
Dieser Operator "sh
ttelt" ein Bild mit m
glicher D
mpfung
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
OriginX,    pixels                          Effekt Zentrum, ohne
OriginY     pixels                          D
mpfungseinwirkung
Amount      pixels                          Effekt-St
Zoom        -10.0...10.0                    Zoom-Wert f
r das ganze Bild
Axis        X, Y                            Effekt-Richtung
Damping     ON, OFF                         an/ausschalten der D
mpfung
Damping     float                           D
mpfungswert
@endnode
@node opShiftLines
@{b}ShiftLines-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ShiftLines.pic"}
Dieser Operator verschiebt die Linien eines Bildes mit m
glichem
Wakkel-Effekt
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Direction   X, Y                            Verschiebungsrichtung
Jitter      ON, OFF                         an/ausschalten des wackelns
Shift       pixels                          Verschiebungs-Wert
Amount      pixels                          Wackel-Wert
Probability 0...100                         Wahrscheinlichkeit f
r den
                                            Wackel-Effekt
Seed        integer                         Start-Wert f
r den
                                            Zufallsgenerator
@endnode
@node opTwirl
@{b}Twirl-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Twirl.pic"}
Dieser Operator f
gt einen nichtlineare Deformation zu einem
Bild hinzu
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
FallOff     IN, OUT                         Radiale Richtung der
                                            Abschw
chung der Deformation
CentreX,    pixels                          Zentrum des Effekts
CentreY     pixels
Radius      pixels                          Radius des zu ver
ndernden
                                            Kreises
Amount      degrees                         Twirl-Wert, selbst sehr gro
                                            Werte (z.B. 1000) sind erlaubt
Power       float                           Parameter der die lokale
                                            Deformation ver
ndert, gro
                                            Werte wie z.B. 6.0 konzentrieren
                                            die Deformation auf das Zentrum
                                            des Kreises
Zoom        -10.0...10.0                    Zoom-Faktor f
r den gew
hlten
                                            Kreisbereich
@endnode
@node opWave
@{b}Wave-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Wave.pic"}
Dieser Operator f
gt eine hrmonische Welle einem Bild hinzu
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX,    pixels                          Zentrum der Welle, der Punkt
CentreY     pixels                          ohne D
,pfung
Amplitude   pixels                          Amplitude der Welle
Phase       degrees                         Phase der Welle
Wavelength  pixels                          Wellel
Shift       pixels                          Diagonale-Verschiebung
Zoom        -10.0...10.0                    Zoom-Wert f
r das ganze Bild
Damping     ON, OFF                         an/ausschalten der D
mpfung
Damping     float                           D
mpfungs-Wert
Axis        X, Y                            Richtung der Welle
Frame       integer>0                       Derzeitiges Bild
Frames      integer>0                       Bildanzahl, die einen
                                            kompletten Zyklus angibt
@endnode
@node opAlpha
@{b}Alpha-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Alpha.pic"}
Dieser Operator ver
ndert die Helligkeit eines Bildes unter
Verwendung eines Alpha-Kanals
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Alpha       STREAM, TEMP1, ..., TEMP8       Alpha Puffer
Left        pixels                          Linke Kante des Alpha Bildes
Top         pixels                          Obere Kante des Alpha Bildes
@endnode
@node opAntique
@{b}Antique-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Antique.pic"}
Dieser Operator ver
ndert die Farben eines Bildes, damit es
"anitique" aussieht.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opBalancing
@{b}Balancing-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Balancing.pic"}
Dieser Operator ver
ndert die Farben eines Bildes mittels diverser
Methoden
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Red         -255...255                      Verschiebungs-Wert f
r die
                                            Rot Komponente
Green       -255...255                      Verschiebungs-Wert f
r die
                                            Gr
n Komponente
Blue        -255...255                      Verschiebungs-Wert f
r die
                                            Blau Komponente
Contrast    -255...255                      Kontrast-Wert, negative Werte
                                            verringern den Kontrast
Bright      -255...255                      Verschiebungs-Wert f
r alle
                                            Farbkan
Gamma       -255...255                      Gamma-Wert
Saturation  -255...255                      Farbs
ttigung
@endnode
@node opBGradient
@{b}BGradient-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/BGradient.pic"}
Dieser Operator ver
ndert die Farben eines Bildes sehr fein. Alle
Funktionen des @{" Balancing " link opBalancing}-PlugIns hat auch dieser
Operator, jedoch kann man mittels eines Vektors (parallel oder radial)
einen Verlauf erzeugen, anstatt die kompletten Farben zu ver
ndern-
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Mode                                        Type des balancing:
             RED                             Verschiebungs-Wert f
r die
                                             Rot Komponente
             GREEN                           Verschiebungs-Wert f
r die
                                             Gr
n Komponente
             BLUE                            Verschiebungs-Wert f
r die
                                             Blau Komponente
             CONTRAST                        Kontrast-Wert, negative Werte
                                             verringern den Kontrast
             BRIGHTNESS                      Verschiebungs-Wert f
r alle
                                             Farbkan
             GAMMA                           Gamma-Wert
             SATURATION                      Farbs
ttigung
X1,         pixels                          Position von Punkt 1 ("Quelle")
Value1      -255...255                      Intensit
t am Punkt 1
X2,         pixels                          Position von Punkt 1 ("Ziel")
Value2      -255...255                      Intensit
t am Punkt 2
Transition                                  Type der Transition:
             PARALLEL                       "normaler" Vektor
             RADIAL                         "kreisf
rmiger" Vektor
@{b}Hinweise@{ub}
1) Wenn der Transition Modus auf "RADIAL" gestellt ist, stellt Punkt 1
   das Zentrum des Kreises dar
2) Da die Koordinaten von Beiden Punkten frei gew
hlt werden k
nnen,
   kann der Vektor in beliebige Richtungen zeigen
   Die derzeitige Richtung erkennt man im Echtzeit-Vorschau-Fenster
3) Mittels des "brightness" Modus kann man Animationen auf sehr
   beeindruckende Weise ein- und ausfaden!
4) Der Gamma-Modus scheint recht lansam zu sein. Dies kommt daher, da
   viele pow(x,a) Werte berechnet werden m
ssen.
5) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opColorToGray
@{b}ColorToGray-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ColorToGray.pic"}
Dieser Operator konvertiert ein Bild in Graustufen
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Weights                                     Gewichtung der RGB Komponenten
            LUMINANCE                        LUMINANCE Gewichtung verwenden
            AVERAGE                          F
r alle Komponenten die
                                             gleiche Gewichtung verwenden
            CUSTOM                           Benutzerdefinierte Gewichtung
Red,        0...10000                        Benutzerdefinierte Werte, die
Green,      0...10000                        die Summe sollte immer 10000
Blue        0...10000                        sein!
@endnode
@node opConvolve
@{b}Convolve-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Convolve.pic"}
Dieser Operator wendet eine 3x3- oder 5x5 Convolution-Matrix auf ein
Bild an
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Mix         0...100                         Intensit
t des Effektes
Shift       -255...255                      Verschiebungswert, der zu jedem
                                            Resultat f
r jeden Pixel addiert
                                            wird. Z.B. kann man damit
                                            negative Werte in den Bereich
                                            0...255 verschieben, ohne Details
                                            zu verlieren
Size        3x3, 5x5
ndern der Matrix-Gr
File        string                          Name zum Laden/Speichern einer
                                            Matrix
Load        (gadget)                        Einladen einer Matrix im
                                            Wildfire oder ADPro Format
Save        (gadget)                        Speichern der Matrix
@endnode
@node opEmboss
@{b}Emboss-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Emboss.pic"}
Dieser Operator konvertiert ein Bild in ein graues Relief
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Direction   NORTHWEST,                      Richtung der Lichtquelle,
            NORTHEAST,                      in verschiedenen Richtungen
            SOUTHWEST,                      k
nnen die Resulate SEHR
            SOUTHEAST                       unterschiedlich aussehen
@endnode
@node opColorRegion
@{b}ColorRegion-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ColorRegion.pic"}
Dieser Operator erkennt einen Bereich mit
hnlichen Farben um ein
vorgegebenes Zentrum herum
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX,                                    Zentrum
CentreY
Tolerance   0.0...1.0                       Toleranz-Level, der `
hnliche`
                                            Pixel definiert
            INCLUDE                          Entfernung aller Pixel, die
                                             nicht zu dem erkannten Gebiet
                                             geh
            EXCLUDE                          Entfernung aller Pixel, die
                                             zum erkannten Gebiet geh
@{b}Hinweise@{ub}
1) Dieser Operator ist sehr n
tzlich f
r fortgeschrittene Compose-
   Methoden oder um Farben eines bestimmten Bereiches zu
ndern.
   (z.B. Ver
ndern der Augenfarbe eines M
dchens --> Gr
n :-)
2) Dieses PlugIn ist zur Zeit noch im Beta-Stadium, der
   komplizierte Algorythmus ist noch nicht optimiert!
3) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opLUT
@{b}LUT-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/LUT.pic"}
Dieser Operator ver
ndert ein Bild mittels einer Farben-Ver
nderungs-Tabelle.
Einem Farbwert X wird ein neuer Farbwert Y zugewiesen.
Im Gegensatz zu vielen anderen
hnlichen Effekten werden die
Werte der LUT (LookUpTable) durch Envelopes vorgegeben und k
gemorpht werden!
Es gibt 6 Envelopes - einen Start- und Endwert f
r jede der
drei Farbkomponenten.
Nach der Angabe der Anzahl der Bilder wird der Start-Envelope in
den End-Envelope gemorpht!
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Mode        EDIT, VIEW                      Anschalten des Editier- oder
                                            des Anzeige-Modus
Type        LINEAR, SPLINE, BEZIER          Type des Splines des gew
hlten
                                            Farbkanals
Component   R, G, B                         Derzeit gew
hlter Farbkanal
RGB         (gadget)                        Derzeitiger Envelope wird auf
                                            alle Farbkan
bernommen
Preset      (may change)                    Auswahl einer Vorgabe
Apply       (gadget)
bernahme der Vorgabe in den
                                            derzeitigen Kanal
Position    START, END                      Auswahl des Anfangs (Start) oder
                                            Schlu
 (End) Envelopes
Both        (gadget)                        Derzeitiger Envelope wird als
                                            Start-und Endwert genommen
Frames      integer>0                       Anzahl der Bilder f
r den
                                            Morph-Vorgang
Frame       integer>0                       Derzeitiges Bild welches im
                                            Anzeige-Modus dargestellt wird
MirrorX     (gadget)                        Spiegelung des Envelopes entlang
                                            der X-Achse
MirrorY     (gadget)                        Spiegelung des Envelopes entlang
                                            der Y-Achse
MirrorXY    (gadget)                        Spiegelung des Envelopes entlang
                                            der Diagonalen
MoveX       (gadget)                        Verschiebung des Envelopes in
                                            X-Richtung
MoveY       (gadget)                        Verschiebung des Envelopes in
                                            Y-Richtung
Amount      integer                         Verschiebungs-Wert
File        string                          Filename zum Speichern/Laden
Load        (gadget)                        Laden eines Envelopes
Save        (gadget)                        Speichern des Envelopes
Es gibt zwei Modi: Den Anzeige (View) und den Editier (edit) Modus.
Im Editier-Modus kann man die Start-und Endwerte ver
ndern, im View
Modus kann man sich das Morphing zwischen Start-und ENdwerten ansehen.
Dabei kann man den Scroillbalken benutzen oder die Bild-Nummer im
"Frame"-Gadget eingeben.
Falls Sie Envelopes im @{"Envelope-Fenster" link EnvelopeWindow} erstellen wollen,
ist die einzige Einschr
nkung, da
 sich alle Werte im Bereich 0...255
befinden m
ssen.
Der erste Punkt mu
 die X-Koordinate 0 besitzen und der letzte Punkt
die Koordinate 255.
@endnode
@node opMedianFilter
@{b}MedianFilter-Operator@{ub}
Dieser Operator bearbeitet das Bild mit einem Median-Filter.
(In den meisten F
llen wird man nur einen geringen Unterschied erkennen.)
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Rect        pixels                          Gr
e des Rechtecks, da
                                            jeden einzelnen Pixel
                                            gescannt wird
@endnode
@node opNegative
@{b}Negative-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Negative.pic"}
Dieser Operator negiert die Farben eines Bildes.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opRIP
@{b}RIP-Operator@{ub}
Dieser Operator entfernt alle isolierten Pixel in einem Bild.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opLineArt
@{b}LineArt-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/LineArt.pic"}
Dieser Operator erzeugt aus einem Bild ein Linien-Art-Bild.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Mode        GRAY, COLOR, INVGRAY , INVCOLOR zu verwendender Algorythmus
@endnode
@node opEdgeDetect
@{b}EdgeDetect-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/EdgeDetect.pic"}
Dieser Operator verwendet eine fortschrittlichen Algorythmus, um Kanten
zu erkennen.
Im Gegensatz zu den
blichen Methoden (z.B. einfache Convolution-Matrix)
bleiben die entdeckten Kanten in den Original-Farben erhalten.
Mittels des Kontrast Wertes kann man "schwache Kanten" unterdr
cken.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Contrast    0...255                         Minimale  "Intensit
t" der
                                            Kanten
@{b}Hinweise@{ub}
1) Sehr kleine Contrast-Werte erzeugen normalerweise keine Kanten,
   aber manchmale sehr "interessante" Bilder
2) St
rende Punkte k
nnen mit dem  @{" RIP " link opRIP}-PlugIn entfernt
   werden
3) Alle Intensit
ten werden mittels Luminance-Gewichtung verarbeitet
@endnode
@node opNoise
@{b}Noise-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Noise.pic"}
Dieser Operator f
gt zuf
lliges Rauschen einem Bild hinzu
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Intensity   color                           Intensit
t des Rauschens
Probability 0...100                         Rausch-Wahrscheinlichkeit
Seed        integer                         Startwert f
r den
                                            Zufallsgenerator
@endnode
@node opOilTransfer
@{b}OilTransfer-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/OilTransfer.pic"}
Dieser Operator wandelt ein Bild in ein
lde um
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Rect        pixels                          Gr
e des Rechteck, welches
                                            f
r jeden Pixel gescannt wird
@endnode
@node opPosterise
@{b}Posterise-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Posterise.pic"}
Dieser Operator reduziert die Anzahl von Bits pro Byte f
r jeden
Pixel des Bildes
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Bits        1...7                           Anzahl von Bits pro Byte,
                                            ein Wert von 8 w
rde nichts
                                            ver
ndern
@endnode
@node opSwapRGB
@{b}SwapRGB-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/SwapRGB.pic"}
Dieser Operator vertauscht die Farbkan
le eines Bildes
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Mode        RBG, GRB, GBR, BRG, BGR         Tausch Modus
@endnode
@node opThreshold
@{b}Threshold-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Threshold.pic"}
Dieser Operator konvertiert ein Bild in ein Schwarz/Wei
 Bild, mittels
Graustufenbildung. Dies ist z.B. f
r Alpha-Kan
le gut geeignet
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Level       0...255                         Graustufen Level, alle Pixel,
                                            deren Helligkeit gr
er als
                                            dieser Wert ist, werden wei
                                            dargestellt, die restlichen
                                            Pixel erscheinen schwarz
@endnode
@node opBump
@{b}Bump-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Bump.pic"}
Dieser Operator benutzt ein zweites Bild um eine H
heninformnation
hinzuzuf
gen, welche durch eine Lichtquelle sichtbar gemacht wird.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
HeightMap   STREAM, TEMP1, ..., TEMP8       Bild das als H
hen-Information
                                            benutzt wird
Amount      integer                         H
he, die einer Helligkeit
                                            von 255 (maximal) entspricht
LightX,     pixels                          Koordinaten der Lichtquelle
LightY,     pixels
LightZ      pixels
Intensity   float                           Licht-Intensit
t (1.0=Normal)
Left        pixels                          Linke Kante des H
hen-Bildes
Top         pixels                          Obere Kante des H
hen Bildes
@endnode
@node opCube
@{b}Cube-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Cube.pic"}
Dieser Operator legt ein Bild auf einen W
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann. Dies spart Speicher und
                                            Zeit.
Size        pixels                          Gr
e des W
rfels
Fold        ON, OFF                         Erstellen des W
rfels durch
                                            Falten des Bildes mittels 5
                                            animierbarer Winkel (wie ein
                                            Paket!)
Alpha4,     degrees                         Winkel zwischen den einzelnen
Alpha5,                                     Fl
chen im Falt-Modus
Alpha2,                                     (siehe Fold)
Alpha6,
Alpha1
Das Bild wird in 6 Teile zerschnitten (2 Reihen, 3 Spalten) und diese
werden dann auf die 6 Fl
chen des W
rfels gelegt.
Um einen W
rfel mit 6 verschiedenen Fl
chen zu erzuegen, mu
 man einfach
6 Bilder Composen und dann dieses Bild als Eingabe f
r den W
Effekt benutzen.
Im Paket-Modus (fold=ON) wird das Bild in zwei Schritten bearbeitet:
Zuerst wird das Bild in die 6 Teile zerlegt:
                                   ___
                                  |   |
                                  | 1 |
   ___________                    |___|___
  |   |   |   |                   |   |   |
  | 1 | 2 | 3 |       \           | 2 | 6 |
  |___|___|___|   =====\       ___|___|___|
  |   |   |   |   =====/      |   |   |
  | 4 | 5 | 6 |       /       | 5 | 3 |
  |___|___|___|               |___|___|
                                  |   |
                                  | 4 |
                                  |___|
Danach werden alle Fl
chen au
er der Nummer 3 um die 5 festgelegten
Winkel rotiert!
 Angle4: Winkel zwischen den Fl
chen 4 und 3
 Angle5: Winkel zwischen den Fl
chen 5 und 3
 Angle2: Winkel zwischen den Fl
chen 2 und 3
 Angle6: Winkel zwischen den Fl
chen 6 und 2
 Angle1: Winkel zwischen den Fl
chen 1 und 2
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opTriangulate
@{b}Triangulate-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Triangulate.pic"}
Dieser Operator konvertiert ein Bild (mit hohen quant3D-Werten) in
ein Phong-Objekt.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       TEMP3D1, ..., TEMP3D4           Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opSetColor
@{b}SetColor-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/SetColor.pic"}
Mit diesem Operator kann man die Farben eines beliebigen 3D Objektes
ndern.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       TEMP3D1, ..., TEMP3D4           Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Red,        0...255                         Farbe, die benutzt werden soll
Green,
Mix         0...100                         Transparenz
Die Transparenz-ption ist vor allem f
r Bilder geeignet, die mehr
als nur einzelne Farben enthalten, wie z.B. Tiere.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opMorph
@{b}Morph-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Morph.pic"}
Dieser Operator erstellt eine Interpolation zwischen zwei Objekten
um ein sogenanntes "Morph-Objekt" zu erzeugen.
Die Punkte und die Objekt-Farben werden gemorpht.
Das Start-und das Endobjekt sollten die gleiche Anzahl von
Punkten und Fl
chen besitzen.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input1      TEMP3D1, ..., TEMP3D4           Start-Objekt
Input1      TEMP3D1, ..., TEMP3D4           End-Objekt
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
Frames      integer>1                       Anzahl der Bilder
Frame       1...frames                      Derzeitiges Bild
Interessante Ergebnisse erreicht man, z.B., wenn man zwei verschiedene
Funktionen, die mit dem Z-Plot Plugin erstellt wName        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input1      TEMP3D1, ..., TEMP3D4           Start-Objekt
Input1      TEMP3D1, ..., TEMP3D4           End-Objekt
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
Frames      integer>1                       Anzahl der Bilder
Frame       1...frames                      Derzeitiges Bild
Interessante Ergebnisse erreicht man, z.B., wenn man zwei verschiedene
Funktionen, die mit dem Z-Plot Plugin erstellt wurden, ineinander
morpht!
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opDataPlot
@{b}DataPlot-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/DataPlot.pic"}
Dieser Operator liest ein 3D-Datenset ein (im gnuplot-Format) und konvertiert
es in ein 3D-Object, welches z.B. in Verbindung mit den ColorCube-Operator
und mit PhongShading gerendert werden kann.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
File        string                          Filename
xQuant,     integer                         Quantisierungs-Werte
yQuant
xScale,     float                           Skalierungs-Werte
yScale,
zScale
Red,        0...255                         Objekt-Farbe
Green,
Grid        ON, OFF                         Zeichnen eines optionalen Rasters
GRed,       0...255                         Raster-Farbe
GGreen,
GGBlue
Die Quantisierungs-Werte sind eine n
tzliche Funktion, um z.B.
Datensets mit sehr hoher Aufl
sung trotzdem mit einem sichtbaren
Raster erscheinen zu lassen.
Nach dem einladen der Daten wird das Set auf eine Aufl
sung von
xQuant*yQuant reduziert. Um diesen EFfekt zu unterdr
cken, w
Sie einfach sehr Hohe Werte wie z.B. 1000.
Die Skalierungs-Werte sind manchmal n
tig, um das Problem mit sehr
unterschiedlichen Achsen-Skalierungen zu beheben.
(z.B. "mm" und "s" im Beispiel-Bild)
Wichtiger Hinweis: Dieses PlugIn benutzt ein Koordinaten-System, das
                   etwas "einfacher" ist, als Wildfires standard
                   Koordinatensystem.
                         y^                  z^
                         | /z                | /y
                         |/                  |/
                          ---> x              ---> x
                        "standard"           DataPlot
                Da das Koordinatensystem nur beim Erstellen der Objekte
                benutzt wird, funktionieren alle Einstellungen wie

blich
@endnode
@node opZPlot
@{b}ZPlot-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ZPlot.pic"}
Dieser Operator erzeugt ein 3D Objekt indem er eine 3D-Funktion f(x,y) wie
z.B. sin(x*x+y*y) plottet. Das erzeugte Objekt kann z.B. in Verbindung mit
dem ColorCube-Operator und unter Verwendung von Phong-Shading gerendert
werden.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
Expression  valid expression in x and y     Funktion f(x,y) zum Berechnen
xMin,       float                           X-Bereich
xMax,       float
xCount      integer
yMin,       float                           Y-Bereich
yMax,       float
yCount      integer
Red,        0...255                         Objekt-Farbe
Green,
Grid        ON, OFF                         Zeichnen eines optionalen Rasters
GRed,       0...255                         Raster-Farbe
GGreen,
GGBlue
Listview   (gadget)                         Einige interessante Voreinstellungen
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
Wichtiger Hinweis: Dieses PlugIn benutzt ein Koordinaten-System, das
                   etwas "einfacher" ist, als Wildfires standard
                   Koordinatensystem.
                         y^                  z^
                         | /z                | /y
                         |/                  |/
                          ---> x              ---> x
                        "standard"           ZPlot
                Da das Koordinatensystem nur beim Erstellen der Objekte
                benutzt wird, funktionieren alle Einstellungen wie

blich
@endnode
@node opParPlot
@{b}ParPlot-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ParPlot.pic"}
Dieser Operator erzeugt ein 3D-Objekt indem er eine pareametrische
3D-Funktion {x(u,v),y(u,v),z(u,v)} wie z.B. einen Torus oder den
Mobius-Streifen berechnet. Das erzeugte Objekt kann z.B. in Verbindung
mit dem ColorCube-Operator und unter Verwendung von Phong-Shading
gerendert werden.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
x           valid expression in u and v     Koordinate x(u,v) zu berechnen
y           valid expression in u and v     Koordinate y(u,v) zu berechnen
z           valid expression in u and v     Koordinate z(u,v) zu berechnen
uMin,       float                           U-Bereich
uMax,       float
uCount      integer
vMin,       float                           V-Bereich
vMax,       float
vCount      integer
Red,        0...255                         Objekt-Farbe
Green,
Grid        ON, OFF                         Zeichnen eines optionalen Rasters
GRed,       0...255                         Raster-Farbe
GGreen,
GGBlue
Listview   (gadget)                         Einige interessante Voreinstellungen
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
Wichtiger Hinweis: Dieses PlugIn benutzt ein Koordinaten-System, das
                   etwas "einfacher" ist, als Wildfires standard
                   Koordinatensystem.
                         y^                  z^
                         | /z                | /y
                         |/                  |/
                          ---> x              ---> x
                        "standard"           ParPlot
                Da das Koordinatensystem nur beim Erstellen der Objekte
                benutzt wird, funktionieren alle Einstellungen wie

blich
@endnode
@node opColorCube
@{b}ColorCube-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/ColorCube.pic"}
Dieser Operator ist einer der m
chtigsten und zugleich kompliziertesten
Operatoren, die Wildfire bietet. Hiermit kann man einen dreidimensionalen
Farbraum oder Lpha-Kanal f
r Objekte oder Bilder erzeugen!
Ein W
rfel wird um das jeweilige Objekt berechnet und an den 8 Ecken des
rfels kann man jeweils eine Farbe ausw
hlen, und zwischen diesen 8
Farben wird im 3D-Raum interpoliert.
Mittels des Alpha-Modes wird nur die Helligkeit des Objektes ver
ndert,
dies macht z.B. die Erzeugung von Nebel oder das `Wrappen` von
Objekten auf Bilder m
glich!
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       TEMP3D1, ..., TEMP3D4           Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Red,        any (!) value                   Die Farbe des gew
hlten Punktes
Green,                                      des W
rfels
Palette     (gadget)                        Auswahl des Punktes
Point       (view only)                     Anzeige der Koordinaten
                                            des Puntes
XCopy,      (gadget)                        Kopieren der Farben des aktuellen
YCopy,                                      Punktes in die angegebene
ZCopy                                       Richtung
Mode        COLOR, ALPHA                    Modus des ColuCubes
Mix         0...100                         Transparenz im Color-Modus
size        CURRENT, ACTUAL                 Berechnung der Gr
e sofort (CURRENT)
                                            oder beim Rendern (ACTUAL)
@{b}Hinweise@{ub}
Jedes Feld des Palette-Gadgets repr
sentiert einen Punkt
des `W
rfels` wie folgt:
       3
         /--------- 4
        / |       /
       /  |      / |         Palette-gadget:
    1  ---------/2 |         _______________
      |   |     |  |        |   |   |   |   |
      |   |     |  |        | 1 | 2 | 3 | 4 |
      |   |-----|--|        |___|___|___|___|
      |  / 7    |  / 8      |   |   |   |   |
      | /       | /         | 5 | 6 | 7 | 8 |
      |/        |/          |___|___|___|___|
       ---------
     5          6
Ein-und zwei-Punkt-Polygone (z.B. das Optionale Raster, welches in den
Plot-Plugins berechnet werden kann) werden nicht durch diesen Operator
ndert!
DIe Gr
en Option kontrolliert das Transformationsverhalten der
Farben. Wenn man "size=CURRENT" verwendet wird die Texture auf
das derzeitige Objekt fixiert. Somit ver
ndern sich die Farben
mit dem Objekt.
Wenn man jedoch "size=ACTUAL" benutzt, wird der ColorCube jeweils
so berechnet, da
 er der Gr
e des (transformierten) Objekts
jederzeit entspricht.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opSphere
@{b}Sphere-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Sphere.pic"}
Dieser Operator legt ein Bild oder einen 3D-Temp-Puffer auf
eine Kugel.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Radius      pixels                          Radius der Kugel
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opTwirl3D
@{b}Twirl3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Twirl3D.pic"}
Dieser Operator berechnet einen Twirl-Effekt f
r ein Bild oder einen
3D-Temp-Puffer entlang einer angegebenen Achse.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Axis        X, Y, Z                         Achse, um die getwirlt wird
Radius      pixels                          Twirl-Radius
Amount      degress                         Twirl-St
re, sehr gro
e Werte
                                            wie z.B. 1000 sind erlaubt
Power       float                           Parameter der die lokale
                                            Deformation ver
ndert, gro
                                            Werte wie z.B. 6.0 konzentrieren
                                            die Deformation auf das Zentrum
                                            des Kreises
OriginX,    pixels                          Zentrum des Effekts
OriginY,    pixels
OriginZ     pixels
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opTwist
@{b}Twist-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Twist.pic"}
Dieser Operator rotiert ein Bild entlang einer angegebenen Achse mit
variierendem Rotations-Winkel und erzeugt ein Helix-
hnliches
aussehen.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Axis        X, Y, Z                         Achse, um die rotiert wird
Amount      degrees                         Maximaler Rotationswinkel
Dist        pixels                          Entfernung des Effekts
OriginX,    pixels                          Der Punkt, an dem die Rotation
OriginY,    pixels                          beginnt
OriginZ     pixels
Negative Dist-Werte sind erlaubt und f
hren dazu, da
 der Effekt
in die entgegengestezte Richtung wirt.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opMagnet3D
@{b}Magnet3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Magnet3D.pic"}
Dieser Operator simuliert das ziehen eines Punktes des Eingabe-Bildes
oder eines 3D-Temp-Puffers unter der Verwendung eines Modells was an
Knetfiguren erinnert. Somit kann man Teilen eiunes Bildes z.B. eine
dritte Dimension hinzuf
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
SrcX,       pixels                          Koordinaten des zu ziehenden
SrcY,       pixels                          Punktes
SrcZ        pixels
DestX,      pixels                          Zielkoordinaten des Punktes
DestY,      pixels
DestZ       pixels
Shape       SMOOTH, SHARP                   Auswahl der Art der Deformation
Strength    float                           Wert, der Ausruck
ber die
                                            Elastizit
t des "Materials" gibt.
                                            Gro
e Werte wie z.B. 5.0 f
                                            dazu, das nur ein kleiner Bereich
                                            des Bildes ver
ndert wird, kleine
                                            Werte wie z.B. 0.1 verformen das
                                            ganze Bild
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opTransform3D
@{b}Transform3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Transform3D.pic"}
Dieser Operator f
hrt einige Standard-3D Transformationen an Bildern
oder 3D-Temp-Puffern aus.
Zum Beispiel kann man dadurch eine Kugel in eine Linse verwandeln oder
3D-Effete entlang verschiedener Achsen legen.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
ScaleX,     -10.0...10.0                    Objekt-Skalierung
ScaleY,     -10.0...10.0
ScaleZ      -10.0...10.0
TransX,     pixels                          Objekt-Verschiebung
TransY,     pixels
TransZ      pixels
Rotate      XY, YZ, XZ, NONE                Rotationsachsenpaar oder
                                            Ausschalten der Rotation
Alpha       degrees                         Erster Rotationswinkel
Beta        degrees                         Zweiter Rotationswinkel
OriginX,    pixels                          Zentrum der Skalierung und
OriginY,    pixels                          Rotation
OriginZ     pixels
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opJoin3D
@{b}Join3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Join3D.pic"}
Dieser Operator verbindet zwei 3D-Temp-Puffer und erlaubt somit das
Composen im 3D-Raum!
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input1      TEMP3D1, ..., TEMP3D4           1. Eingabe-Puffer
Input2      TEMP3D1, ..., TEMP3D4           22. Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
Centre      ON, OFF                         Zentrieren der Objekte
Da keine weiteren Transformationen stattfinden sollten die benutzen
Objekte verschieden sein, da ansonsten das Composing keinen Sinn
ergibt.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opBump3D
@{b}Bump3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Bump3D.pic"}
Dieser Operator benutzt die Graustaufen-Werte einer Bump-Map als Z-Werte
r eine Bild oder einen 3D-Temp-Puffer. F
r gute Resultate sollte
die Bump Map sehr fein sein, solche Bilder k
nnen mit der 5x5 Matrix
(voreingestellte Werte verwenden) des @{" Convolve " link opConvolve}-Operators erstellt
werden!
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Map         STREAM, TEMP1, ..., TEMP8       Bump-Map
Amount      integer                         H
he, die einem (maximalen)
                                            Graustufen Wert von 255 entspricht
NoGround    ON, OFF                         Abziehen des "ground"
                                            (Durchschnitt) der Bumpmap, um
                                            nur Kontrast und keine
                                            Verschiebung zu erzeugen
Width       pixels                          Breite der Bump-Map
Height      pixels                          H
he der Bump-Map
Aspect      IGNORE, TAKEWIDTH, TAKEHEIGHT   Aspect der Mump-Map
                                            (sihe @{" Scale " link opScale})
OriginX     pixels                          Linke Kante der Bump-Map
OriginY     pixels                          Obere Kante der Bump-Map
Centre      ON, OFF                         Zentrierung der Bump-Map innerhalb
                                            des Eingabe-Bildes
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opGenlock3D
@{b}Genlock3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Genlock3D.pic"}
Dieser Operator entfernt alle Fl
chen, die eine Farbauswahl entsprechen,
um eine Genlock-artigen EFfekt zu erzeugen.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Red1,       0...255                         Genlock-Farbe 1
Green2,     0...255
Blue        0...255
Red2,       0...255                         Genlock-Farbe 2
Green2,     0...255
Blue2       0...255
Genlock                                     Type des genlock:
            SINGLE COLOR                     normales genlock mit der Farbe 1
            INRANGE                          erweitertes Genlock unter
                                             Verwendung aller Farben innerhalb
                                             des Bereiches Farbe1...Farbe2
            OUTRANGE                         erweitertes Genlock unter
                                             Verwendung aller Farben au
erhalb
                                             des Bereiches Farbe1...Farbe2
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opAxis3D
@{b}Axis3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Axis3D.pic"}
Dieser sehr komplexe Operator f
gt 3D-Achsen inklusive
 *Abschnittsmarkierungen
 *Abschnittsbezeichnungen
 *Achsenbezeichnungen
zu jedem beliebigen 3D Objekt hinzu. Haupts
chlich ist dieser Operator
entwickelt worden, um 3D Koordinatensysteme in extrem hoher Aufl
(z.B. 1280x800) mit sehr guten Datenplots etc. zu verbinden.
Solche Bilder k
nnen dann z.B. in TeX-Dokumente mittels des
@{" EPSSavers " link svEPS}  eingebunden werden.
Da die Erzeugte Achsen-Box 12 Kanten hat, gibt es 4 M
glichkeiten, die
X-,Y- und Z-Achsenbezeichnungen zu plazieren.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       TEMP3D1, ..., TEMP3D4           Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Axis        X, Y, Z                         Achse, die ver
ndert werden soll
Min,        float                           Bereich der derzeitigen Achse
Mode        AUTOMATIC, MANUAL               Modus zum Berechnen der
                                            Achsenabschnittsmarkierungen
Ticks                                       Anzahl der Markierungen
                                            (Mode=AUTOMATIC)
LMin,       float                           Markierungs-Bereich (Mode=MANUAL)
LMax,
Thickness   pixels                          St
rke der Achsen und der
                                            Markierungen
TickSize    pixels                          L
nge der Markierungen
Red,        0...255                         Farbe der Achsen und der
Green,                                      Markierungen
Labels      ON, OFF                         An/Ausschalten der Bezeichnungen
FontSize    pixels                          H
he der Abschnittsbezeichnungen,
                                            die Achsenbezeichnungen werden
                                            automatisch etwas gr
                                            dargestellt
Place                                       Plazierung der Bezeichnungen,
                                            die "richtigen" Werte h
                                            von der Betrachtungs-Richtung ab
            FRONTBOTTOM, FRONTTOP,
            BACKBOTTOM, BACKTOP (x-axis)
            RIGHTBOTTOM, RIGHTTOP,
            LEFTBOTTOM, LEFTTOP (y-axis)
            FRONTRIGHT, FRONTLEFT,
            BACKRIGHT, BACKLEFT (z-axis)
LSkip       float                           Zus
tzlicher Freiraum zwischen den
                                            Achsen und den Bezeichnungen
LAlpha,     degrees                         M
gliche Rotationswinkel f
r die
LBeta                                       Bezeichnungen
LRed,       0...255                         Farbe der Bezeichnungen
LGreen,
lBlue
Label,      string                          Weitere Bezeichnung
Phong       ON, OFF                         An/ausschalten des Phong-Shading
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@{b}Hinweise@{ub}
1. Dieses PlugIn benutzt ein Koordinaten-System, das
   etwas "einfacher" ist, als Wildfires standard Koordinatensystem.
            y^                  z^
            | /z                | /y
            |/                  |/
             ---> x              ---> x
           "standard"           Axis3D
  Da das Koordinatensystem nur beim Erstellen der Objekte
  benutzt wird, funktionieren alle Einstellungen wie
blich
2. Wie bereits oben erw
hnt kann man dieses PlugIn benutzen, um
   Plots in sehr hoher Qualit
t zu erzeugen. Daf
r ist sehr viel Speicher,
   eine hohe Aufl
sung (100...300 dpi) und zumindest ein 68060er
   Prozessor zu empfehlen!
   Wenn solche High-End Bilder in TeX Dokumente eingebunden werden, erh
   man leicht Files, die ohne weiteres 20 MB gro
 sind. Auch dies ist
   ganz normal.
3. Vergessen Sie nicht die Hintergrundfarbe auf Wei
 zu setzen,
   (im @{" Processor " link ProcessorWindow}-Fenster) falls Sie das Bild
   sp
ter ausdrucken wollen.
4. Der "AUTOMATIC"-Modus benutzt eine intelligente Methode, um die
   "richtigen" Schrittweiten zu berechnen. Jedoch sind in manchen
llen die derste oder die letzte Markierung zu nah and
   der Achse. In diesem Fall ver
ndern Sie den Bereich ein wenig
   per Hand.
@endnode
@node opLWOB
@{b}LWOB-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/LWOB.pic"}
Dieser Operator liest ein Lightwave-Objekt ein und konvertiert es in
Wildfires 3D-Format. Mit Hilfe des @{" PowerPlugs!-concept " link PowerPlugs!}-Konzepts kann
man somit Phong-Shaded 3D Objekte mit Bildern u.s.w. kombinieren.
Nur 1-, 2-, 3- und 4-Punkt Polygone werden unterst
tzt, alle anderen
Polygone werden beim einlesen ignoriert.
Um das Erstellen von Objekt-Katalogen zu erm
glichen, kann man den
Filenamen direkt in das generierte Bild plotten lassen und
auch komplette Directorys scannen lassen!
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
Text                                        an/ausschalten des Textes, der
                                            in das Bild geplottet wird
            OFF,                             kein Text,
            SMALL,                           Filename ohne Pfad,
            FULL                             Filename mit Pfad
Select Font (gadget)                        Auswahl des Zeichensatzes f
                                            den Text
File        string                          Objekt-File oder Directory
Width       pixels                          Breite des zu erzeugenden Bildes
Height      pixels                          H
he des zu erzeugenden Bildes
TRed,       0...255                         Text-Farbe
TGreen,     0...255
TBlue       0...255
Wenn das Eingabe-File nicht gefunden wird, scannt Wildfire die angegebene
Directory und erstellt eine alphabetisch sortierte Fileliste.
ter wird das n-te Objekt bei Bild n bearbeitet.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opPerspective
@{b}Perspective-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Perspective.pic"}
Dieser Operator f
gt Perspective zu einem Bild hinzu.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opWater
@{b}Water-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Water.pic"}
Dieser Operator berechnet eine nicht-harmonische Wasserwelle auf ein
Bild.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Frame       integer>0                       Derzeitiges Bild
Frames      integer>0                       Bildanzahl die einem vollen
                                            Durchlauf entspricht
Times       integer>0                       Anzahl der Ringe, Werte im
                                            Bereich 1..3 sehen meistens
                                            gut aus
Rings       integer>0                       Angabe wie oft die Ringe entstehen,
                                            nach einem Cyclus hat der 1. Ring
                                            den Abstand times*wavelength vom
                                            Zentrum, Werte zwischen 2..10
                                            ergeben gute Resultate
Axis                                        Richtung der Bewegung,
            X,                               Parallel zur X-Achse,
            Y,                               Parallel zur Y-Achse,
            XY,                              Radiale Bewegung
Amplitude   pixels                          Wellen-Amplitude
Wavelength  pixels                          Wellenl
OriginX,    pixels                          Koordinaten des Wellenursprungs
OriginY     pixels
Damping     ON, OFF                         an/ausschalten der D
mpfung
Damping     float                           D
mpfungs-Wert
moveXY      ON, OFF                         Gibt an, ob die Deformation f
                                            alle Komponenten (x,y,z) berechnet
                                            wird, oder nicht. Wenn diese Option
                                            angeschaltet ist, k
nnen einige
                                            Singularit
ten auftreten, trotzdem
                                            ist dies dann sehr realit
tsnah.
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opWave3D
@{b}Wave3D-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Wave3D.pic"}
Dieser Operator berechnet eine Welle im 3D Raum auf ein Bild.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Frame       integer>0                       Derzeitiges Bild
Frames      integer>0                       Bildanzahl die einem vollen
                                            Durchlauf entspricht
Amplitude   pixels                          Wellen-Amplitude
Wavelength  pixels                          Wellenl
Phase       degrees                         phase
Axis                                        Richtung der Bewegung,
            X                                Parallel zur X-Achse
            Y                                Parallel zur Y-Achse
            XY                               Radiale Bewegung in der
                                             XY-Ebene
            RADIAL                           Radiale Bewegung im
                                             XYZ-Raum
OriginX,    pixels                          Koordinaten des Wellenursprungs
OriginY     pixels
Damping     ON, OFF                         an/ausschalten der D
mpfung
Damping     float                           D
mpfungs-Wert
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opWrap
@{b}Wrap-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Wrap.pic"}
Dieser Operator legt ein Bild auf eine Kugel oder eine R
Ein EInzigartiger Effekt is die Deformation von nicht "gewrappten"
Teilen des Bildes im "Radius"-Modus.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8,      Eingabe-Puffer
            TEMP3D1, ..., TEMP3D4
Ouput       STREAM, TEMP1, ..., TEMP8,      Ausgabe-Puffer
            TEMP3D1, ..., TEMP3D4
TRender     ON, OFF                         Gibt an, ob der 3D Puffer zum
                                            letzten mal benutzt wird, und
                                            somit direkt ver
ndert werden
                                            kann.
                                            Dies spart Speicher und Zeit.
Axis                                        Wrap Achse
            X,                               `Wrap`en des Bildes auf eine
                                              R
hre entlang der X-Achse
            Y,                               `Wrap`en des Bildes auf eine
                                              R
hre entlang der Y-Achse
            XY,                              `Wrap`en des Bildes auf eine
                                              Kugel
OriginX,    pixels                          Ursprungskoordinaten der R
OriginY     pixels                          bzw. Kugel
Amount      0...100                         Wrap-St
Radius      pixels                          Radius der Kugel oder der R
Method                                      Wrap-Methode:
            RADIUS,                          Erzeugung einer Kugel/R
hre mit
                                             dem angegebenen Radius, `wrap`en
                                             des Bildes auf sie, au
erdem
                                             Deformation der nicht-ge`wrap`ten
                                             Bildteile
            AMOUNT                           Erzeugung einer Kugel/R
hre, auf
                                             die das gesamte Bild pa
t, der
                                             `Amount` gibt  gibt die St
                                             in Prozent an
Da dieser Operator das @{" PowerPlugs! " link PowerPlugs!}-Konzept unterst
nnen weitere Einstellungen im @{" Render-Settings " link RenderSettings}-Fenster getroffen werden.
@endnode
@node opARexx
@{b}ARexx-Operator@{ub}
Dieser Operator erm
glicht es Wildfire, Bilder mit anderen Aplikationen
auszutauschen.
Das Grundkonzept ist, ein ARexx-Skript zu erzeugen, welches
das fremde Programm dazu bringt, ein Wildfire Bild zu laden,
zu bearbeiten und danach zu speichern.
@{b}Parameter@{ub}
Name         M
gliche Werte/Puffer           Beschreibung
@{uu}
Input        STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput        STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Port         string                          ARexx-Port der Application
Temp-File    string                          Pfad f
r Tempor
re Files
Add          (gadget)                        Hinzuf
gen einer Zeile zum
                                             ARexx-script
Kill         (gadget)                        L
schen der ausgew
hlten Zeile
Up           (gadget)                        Bewegen der ausgew
hlten Zeile
                                             nach oben
Down         (gagget)                        Bewegen der ausgew
hlten Zeile
                                             nach unten
Clear        (gadget)                        L
schen des ganzen Skripts
Add Variable (gadget)                        Hinzuf
gen einer Variable zum
                                             Skript
Import       (gadget)                        Laden eines Skripts
Export       (gadget)                        Speichern des Skripts
Ein "normales" Skript sollte mindestens folgende 3 Teile enthalten:
 -laden des tempor
ren - von Wildfire erzeugten - Bildes
 -verarbeiten des Bildes
 -speichern des Resultates
Der 3. Punkt ist natr
lich der wichtigste.
Jede Zeile des Skriptes mu
 im Format des C-printf-Kommandos
eingegeben werden. Dadurch kann man auch Envelopes in solchen
ARexx-Skripten verwenden.
Der Grund-Syntax lautet:  "<formatstring>",arguments
(Die einschlie
enden '"'-Zeichen sind wichtig.)
Drei Formate werden unterst
 "%s" - f
r Zeichenetten
 "%d" - f
r Integer Parameter
 "%f" - f
r Floating-Point Parameter
Die Anzahl der Format-Platzhalter mu
 mit der Anzahl der Argumente
bereinstimmen. Spezielle Format-Strings wie z.B. "%.4lf" werden
nicht unterst
Beispiel:
 eingegebene Zeile:                 von Wildfire generiertes Ergebnis
  "integer: %d",10.3                  integer: 10
  "float: %f",10.3                    float: 10.3
  "i: %d, f: %f, s: '%s'",4,3,str     i: 4, f: 3.0, s: 'str'
Um einen Envelope zu benutzen, geben Sie einfach seinen Namen als
Argument an! Wenn "%d" als Formatstring angegeben wird, wird gerundet.
Der Filename des Temp-Files kann ausgelassen werden, wenn man auf
das vordefinierte Argument "tempfile" ausweicht.
Nun lassen Sie uns ein Beispiel erstellen. Wir wollen ADPro
dazu bringen, unser Bild zu halbieren und einen Antique-Effekt zu
berechnen.
Zuerst mu
 der Pfad des externen Programmes im @{" Preferences-Fenster " link PreferencesWindow}
eingegeben werden. (Falls sein ARexx-Port nicht gefunden wird, versucht
Wildfire das Program zu starten.)
Danach m
ssen wir den Port-Namen angeben, in unserem Fall ist dies
"ADPro"
In der ersten Zeile des Skripts geben wir ADPro`s default-Loader an:
 "lformat "universal""
Nun laden wir das Bild
 "load '%s'",tempfile
Lassen die Effekte berechnen
 "operator halve"
 "operator antique"
Geben das Speicherformat an
"sformat "iff""
und speichern das Bild ab
 "save '%s' raw",tempfile
Das wars schon, nun haben Sie folgendes Skript:
 "lformat "universal""
 "load '%s'",tempfile
 "operator halve"
 "operator antique"
 "sformat "iff""
 "save '%s' raw",tempfile
als "Reference-Skript". F
r weitere Effekte m
ssen Sie nur die "Operator"
Zeilen ver
ndern.
@endnode
@node opComment
@{b}Comment-Operator@{ub}
Dieser Operator erlaubt es, einen Kommentar in das Prozessor-Skript
einzuf
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer     Beschreibung
@{uu}
String      string                    der Kommentar
@endnode
@node opRaster
@{b}Raster-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Raster.pic"}
Dieser Operator legt ein schwarzes Raster
ber ein Bild. Eine Anwendung
dieses Effekts kann die Reduzierung der Gr
e von Delta-Animationen sein,
ohne zu viele Details zu verlieren.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opFieldRendering
@{b}FieldRendering-Operator@{ub}
Dieser Operator konvertiert Bilder in "fields".
Field-Rendering wird benutzt, um Animationen sanft abzuspielen
und arbeitet nach einem
hnlichen Modus wie die Interlaced
Bildschirme. Bei jedem dargestellten Bild wird nur die H
ndert. Daraus folgt eine h
here m
gliche Abspielgeschwindigkeit,
da nur noch Animationen mit der halben urspr
nglichen Gr
e bearbeitet
werden m
ssen.
Bei jedem ungeraden Bild werden die geradeen Linien
bersprungen
und umgekehrt. Beispiel: Bei Bild Nummer 1 enth
lt das erzeugte
Animations-Bild die Linien 1, 3, 5, ...
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
@endnode
@node opCircle
@{b}Circle-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Circle.pic"}
Dieser Operator zeichnet einen - wahlweise gef
llten - Kreis
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
CentreX,    pixels                          Zentrum des Kreises
CentreY
Radius      pixels                          Radius des Kreises
Thickness   pixels                          Dicke, Werte gr
er als
                                            Radius/2 f
                                            zu ausgef
llten Kreisen
Red,        0...255                         Farbe des Kreises
Green,
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opRectangle
@{b}Rectangle-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Rectangle.pic"}
Dieser Operator zeichnet ein - wahlweise gef
lltes - Rechteck
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Left,       pixels                          Obere Linke Ecke
Top
Width,      pixels                          Gr
e des Rechtecks
Height
Thickness   pixels                          Dicke, Werte gr
er als
                                            H
he/2 f
hren zu
                                            ausgef
llten Rechtecken
Red,        0...255                         Farbe des Rechtecks
Green,
@{b}Hinweise@{ub}
1) Dieses PlugIn unterst
tzt das "Parameter-dragging" aus dem
   @{" Bild-Koordinaten-Fenster " link ImageCoordinatesWindow}.
@endnode
@node opSetBackground
@{b}SetBackground-Operator@{ub}
Mit diesem Operator kann man die Globale Hintergrundfarbe (siehe auch
@{" Processor-Fenster " link ProcessorWindow}) dynamisch
ndern.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Red,        0...255                         Farbe
Green,
Hinweise:
Die Originalwerte werden gespeichert und nach dem Prozess wieder
ckgesetzt.
@endnode
@node opGetDimensions
@{b}GetDimensions-Operator@{ub}
Dieser Operator beschreibt die voreingestellten Symbole "pcHeight" (H
und "pcWidth" (Breite) mit den Werten des eingestellten Puffers.
Mit Hilfe dieser Symbole ann man Skripte erstellen, die von der
e der Eingaben unabzh
ngig sind und sich automatisch anpassen!
Siehe auch das @{" Variables-Fenster " link VariablesWindow}.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Input       STREAM, TEMP1, ..., TEMP8       Eingabe-Puffer
Output                                      Symbol, welches ver
ndert wird
            WIDTH                            pcWidth
            HEIGHT                           pcHeight
            BOTH                             pcWidth und pcHeight
@endnode
@node opText
@{b}Text-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/Text.pic"}
Dieser Operator rendert Text in verschiedenen Styles. Im Gegensatz zu
vielen anderen Programmen k
nnen ganze Textfiles verwendet und editiert
werden.
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Ouput       STREAM, TEMP1, ..., TEMP8       Ausgabe-Puffer
Style                                       Render-Style
            NORMAL                           Verwendung des Fonts ohne
                                             jegliche
nderung, z.B. bei
                                             Colorfonts angebracht
            OUTLINE                          Zeichnen der Au
enlinien des
                                             gew
hlten Fonts
            EMBOSS                           Erzeugung eines 3D-Aussehens
Adjust      LEFT, CENTERED, RIGHT           Text-Positionierung, dies hat
                                            nur eine Auswirkung, wenn mehr
                                            als eine Zeile gezeichnet wird
Red,        0...255                         Text-Farben
Green,      0...255
Blue        0...255
Strength    pixels                          Dice der Au
enlinie um den Text
                                            im OUTLINE- oder EMBOSS-Mode
Intensity   float                           Licht-Intensit
t (1.0=normal)
LightX,     pixels                          Licht-Position
LightY,     pixels
LightZ      pixels
HSkip       pixels                          Zus
tzlicher Raum zwischen
                                            zwei Zeilen
Select Font (gadget)                        Auswahl des Zeichensatzes
Add         (gadget)                        Hinzuf
gen einer Zeile
Kill        (gadget)                        L
schen der Zeile
Up          (gadget)                        Verschieben der Zeile nach oben
Down        (gadget)                        Verschieben der Zeile nach unten
Clear       (gadget)                        L
schen aller Zeilen
Import      (gadgt)                         Einladen eines Textes
Export      (gadget)                        Speichern des Textes
@endnode
@node opGSImport
@{b}GSImport-Operator@{ub} @{" Beispiel " system "visage wf:doc/pictures/GSImport.pic"}
This PlugIn startet Ghostscript um Postscript (TM)-Files einzuladen.
Um Zeit und Speicher zu sparen wird nur die erste Seite des Dokumentes
bearbeitet. Der Haupt-Zweck dieses Plugins ist das Konvertieren von
EPS-Illustrationen in `editierbare Bilder`
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Output      STREAM, TEMP1, ..., TEMP8  Ausgabe-Puffer
File        string                     Postscript-File
Resolution  integer                    Aufl
XGeom,      pixels                     Ausschnitt
YGeom
View        (gadget)                   Anzeige des Files
@{b}Hinweise@{ub}
A) Dieses Plugin ben
tigt eine komplette Ghostscript-installation.
   Da nur das ppmraw-device benutzt wird, ist keine spezielle
   Version Voraussetzung. Selbst V 2.62 f
r AmiWin lief ohne
   Probleme.
B) Dieses PlugIn ist recht langsam, aber im Vergleich mit
hnlichen
   X11 Tools ist das ganz normal.
C) Wenn Sie sehr kleine Teile in hoher Aufl
sung einladen wollen,
ssen Sie die Geometrie-Parameter benutzen.
   Beispiel:
   Ihr Bereich hat eine Dimension von 3x2,5 cm und Sie wollen ihn in
   einer Aufl
sung von 120 dpi einladen. Wenn Sie die Geometrie-Parameter
   nicht ver
ndern, wird die ganze Seite in dieser Aufl
sung bearbeitet
   und das kostet nat
rlich sehr viel Zeit und sehr viel Speicher.
   In diesem Beispiel sollten Sue einen Ausschnitt von 320x256
   angeben!
D) Verwenden Sie das @{" AutoCrop " link opAutoCrop}-PlugIn um die
   "Interessanten Regionen" der Importierten Seite herauszufiltern!
@{b}Copyrights@{ub}
Ghostscript is Copyright (C) 1989, 1992, 1993 Aladdin Enterprises.
PostScript is a trademark of Adobe Systems, Incorporated.
AmiWin is Copyright (C) 1994, 1995 Holger Kruse.
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Developer
@remark */
@remark /*************************************************************/
@node Developer
@{b}Das YAFA-Format@{ub}
Wenn Sie einen eigenen YAFA-Player schreiben wollen oder das YAFA
Animationsformat in Ihren Projekten Unterst
tzen wollen, sollten
Sie einen Blick auf die @{" YAFA-Format-Beschreibung " link YAFA-doc.guide/MAIN} werfen!
@{b}Wildfire-PlugIns@{ub}
Wenn Sie andererseits daran interessiert sind, weitere Wildfire Plugins
(Saver, Operatoren oder Generelle Plugins) zu erzeugen, sollten Sie
dies uns mitteilen (email: [e-mail]).
Wenn mindestens 10 wirkliche Anfragen eingehen, beginnt der Autor mit
einem Developer-Kit einschlie
lich Beispielen und voller Dokumentation.
Zur Zeit (Sunday 05-Oct-97) gibt es nur zwei Anfragen.
Der einzige unterst
tze Compiler ist GCC, aber SAS d
rfte auch funktionieren.
@endnode
@remark /*************************************************************/
@remark /*
@remark                            ARexx
@remark */
@remark /*************************************************************/
@node ARexx
@{b}Der ARexx-Port@{ub}
 Der ARexx-port ist ein weiterer
berragender Programmteil von Wildfire.
 Unter anderem kann man damit:
  - Alle Befehle von Wildfire aus anderen Programmen heraus benutzen
  - die Benutzeroberfl
che mit eigenen Fenstern ver
ndern
  - eigene ARexx-Programme schreiben, die wie Teile des Programms arbeiten
  Beispiel:
           Sie haben einen sehr guten Spezial-Effekt kreeiert, z.B. eine
           Transition zwischen mehreren Animationen. Nun wollen Sie diesen
           Effekt in Wildfire einbinden, damit Sie ihn benutzen k
nnen,
           als w
re er ein im Programm integriertes Feature.
           Nichts einfacher als das. Sie brauchen nur ein eigenes Fenster
           mit Gadgets, Schaltern etc. zu designen und m
ssen die
           eigentliche Prozedur schreiben.
@{b}Themen:@{ub}
 @{" Benutzung         " LINK ARexxUsage}
 @{" Fehler-Meldungen  " LINK ARexxErrors}
 @{" Eigene-Fenster    " LINK ARexxCWindows}
 @{" Kommandos         " LINK ARexxCommands}
@endnode
@node ARexxUsage
Der Name des ARexx Ports ist gleich dem Public-Screen Namen, den man lesen
kann, wenn man in den Wildfire Screen klickt.
Die erste laufende Kopie von Wildfire erh
lt den Namen "Wildfire".
Die n
chste Kopie hei
t dann "Wildfire.1" u.s.w.
Obwohl es nicht n
tig ist mehrere Kopien von Wildfire laufen zu lassen,
ist es nat
rlich m
glich.
Die Hierarchie der Befehle ist genauso angeordnet, wie die
Benutzeroberfl
che. Somit kann man sehr schnell den richtigen ARexx Befehl
aus dem sehr gro
en Umfang von Befehlen herausfinden.
Zum Beispiel hei
t der "Play" Knopf im Player-Fenster "P_Play"
Die meisten Argumente, die
bergeben werden m
ssen, sind Strings oder
Integer Werte. Es wird empfohlen, Sie in "'" Zeichen einzuschlie
Es gibt 3 M
glichkeiten, ARexx-Kommandos zu benutzen:
 1. Skripte
  1a) aufgerufen als Macro, wenn man eine Funktionstaste in Wildfire dr
  1b) von der Shell gestartet
 2. direkte Befehle
 3. externe Programme
Direkte Befehle ann man benutzen, um Kommandos schnell und ohne Umwege
auszuprobieren. Zum Beispiel m
chte man das "PL_APPENDDIR" Kommando testen:
 rx "address 'Wildfire'
pl_appenddir 'data:grafix/frames'
Eine andere M
glichkeit um einzelne Kommandos zu testen ist die
Benutzung des "Command"-PlugIns.
Ein Eingabe-String
 "pl_appenddir 'data:grafix/frames'"
rde das selbe Resultat hervorbringen, wie oben beschrieben.
Der Vorteil des Command-PlugIns ist die Geschwindigkeit, da es
nicht ARexx benutzen mu
 und die Resultate im gleichen
Fenster anzeigt (ARexx-Fehlermeldungen sind meist recht kryptisch)
Im Verzeichnis wf:macros/ befinden sich einige kleine Macros, unter
nden ist es hilfreich, sich diese Macros anzusehen.
@endnode
@node ARexxCWindows
 In Wildfire kann man auf einfache Weise eigene Fenster
 erzeugen, l
schen, verwalten etc. So ist es leicht m
glich, Toolmanager
hnliche Befehlsleisten zu erzeugen, die beim starten von Wildfire
 geladen werden.
 Der Haupt-Grund f
r die Einf
hrung von einem solchen Feature war, da
 die F
higkeiten und das Aussehen des Programms auf einfachste Weise an
 Ihre pers
nlichen Bed
rfnisse anpassen k
nnen.
4.1 Fenster-Elemente
-------------------------------------------------------------------
 Sie k
nnen in den Fenstern folgende Elemente einbauen:
  -buttons        (Kn
  -string-gadgets (Text-Eingabezeilen)
  -switches       (Umschalter)
  -lines          (Linien)
  -boxes and      (Rechtecke)
  -texts.         (Texte)
 Alle diese Elemente bleiben im Fenster, solange sie nicht gel
 werden.
 Aber Sie habe die M
glichkeit, andere grafische Elemente einzubauen,
 die nicht in der Fensterstruktur abgespeichert werden. So k
 Sie leicht einen Progre
-Anzeige oder einen Funktionsplotter
 generieren.
 Vorsicht:
 Falls Sie Leerzeichen in den Fenster - oder Gadget Namen verwenden
 wollen, m
ssen Sie einen Speziellen Buchstaben (code 160) benutzen,
 und nicht die Leertaste.
 (DIese Einschr
nkung entsteht durch den optimierten Parser)
 Beispiel:
 space='a0'x
 wnd="Transition.rexx" || space || "V0.3"
4.2 Fenster Koordinaten
------------------------------------------------------------------
 Da Wildfire eine Fontsensitive Benutzeroberfl
 besitzt, kann man keine festen Koordinaten beutzen, um die Positionen der
 Fensterbestandteile festzulegen.
 Am besten designt man seine Fenster mit Hilfe eines topaz.8-font um
 sicherzustellen, da
 Sie auch mit anderen Fontgr
en gut aussehen.
 Falls Sie ein gr
eres Fenster mit vielen Elementen entwerfen wollen,
re es keine schlechte Idee, die GadToolsBox
 zu benutzen.
 Erstellen Sie damit Ihr fenster und verwenden Sie einfach die erhaltenen
 Koordinaten.
4.3. Ein einfaches Beispiel
-------------------------------------------------------------------
 Das folgende Programm Namens "ConvertPics.rexx"
ffnet ein Fenster,
 in dem man eine bestimmte Anzahl von Bildern aus der Bilderliste
 ausw
hlen kann und diese mittels eines "Convert" Knopfes konvertieren
 kann. Somit kann man an wenigen Bildern das Erstellen einer Animation
 testen, falls man langwierige Processe auf die Animation anwendet.
 1. Programm Aufbau
    (i) Fenster erstellen, Variablen initialisieren
    (ii) Endlos-Schleife ausf
hren und verschiedene Abfragen durchf
hren:
          1. Kontrolle, ob Gadgets gedr
              -> Filerequester starten, Eingaben
bernehmen
          2. Kontrolle des Schlie
-Gadgets
              -> ENde
          3. Kontrolle des Start-Gadgets
              -> Parameter kontrollieren
              -> Konvertieren
 2. Program
    /* Alles bereit ? */
    if ~show('P','Wildfire') then do
     say " Fehler: Wildfire mu
 gestartet werden, um das Script zu benutzen."
     exit
    end
    /* Globale Variablen initialisieren */
    address "Wildfire"
    options results
    wnd="Convert"
    from=1
    to=1
    /* Fenster erstellen */
    cw_kill wnd
    cw_add wnd 309 70
    /* Gadgets erstellen */
    cw_addgadget wnd string 202 11 84 "Von"
    cw_addgadget wnd string 202 27 84 "Bis"
    cw_addgadget wnd button 25 46 261 "Convert"
    /* Es ist wichtig erst das Fenster zu
ffnen und dann die Gadgets zu setzen */
    cw_open wnd
    cw_setgadget wnd "From" from
    cw_setgadget wnd "To" to
    /* Hauptschleife */
    do forever
     /* Kontrollieren, ob das Fenster noch offen ist */
     cw_isopen wnd
     qt=result
     /* Nein: Script verlassen */
     if qt=0 then call cleanup
     /* Auf Gadgets warten */
     cw_wait wnd
     gadget=result
     /* Welches Gadget wurde gedr
ckt? */
     if gadget="From" then do
      /*  "Von"-Wert aus dem Gadget holen */
      cw_getgadget wnd "From"
      from=result
     end
     else if gadget="To" then do
      /* "Bis"-Wert aus dem Gadget holen */
      cw_getgadget wnd "To"
      to=result
     end
     else if gadget="Convert" then do
      /* auf gehts, Konvertieren! */
      c_convertpics from to
     end
    end
    cleanup:
    cw_kill wnd
    exit
 GadToolsBox is Copyright
 1991-93 Jaba Development
@endnode
@node ARexxErrors
Es gibt 4 Fehler Meldungen, die zusammen mit dem Befehl im voreingestellten
CON: Fenster angezeigt werden:
 1: falsche Anzahl an Argumenten
 2: falsche Argumente
 3: unbekannter Befehl
 4: Befehl fehlgeschlagen
Die meisten Befehle k
nnen zu jeder Zeit ausgef
hrt werden. Aber es gibt
auch Ausnahmen. Falls Sie z.B. keine Variable definiert haben, k
nnen Sie
das Envelope-Fenster nicht
ffnen. Dies w
rde Fehler 4 hervorrufen.
Normalerweise mu
 man, um die Befehle auszuf
hren, die zugeh
rigen Fenster
nicht
ffnen. Ausnahmen bilden:
 -Timecodes-, AnimInfo-, Envelope- and EnvelopeAdvanced-Befehle
 das korrespondierende Fenster ge
ffnet sein. Dies ist kein Fehler,
es ist durch die interne Datenstruktur bedingt.
Wenn das Program ein ARexx Befehl ausf
hrt, werden alle Requester - au
die durch den "M_MESSAGE" Befehl hervorgerufenen - ausgeschaltet. Die
Requester-Ausgaben werden jedoch an das CON: - Fenster weitergeleitet.
@endnode
@node ARexxCommands
Die folgende Liste zeigt alle m
glichen Befehle. Werte in den eckigen
Klammern sind alternative Schl
sselw
rter.
 Main:
  M_EXIT
  M_QUIT
  M_WAIT secs
  M_MESSAGE text
  M_REQUEST text (res=0: o.k.)
  M_OPENCONVERTER
  M_CLOSECONVERTER
  M_OPENPROCESSOR
  M_CLOSEPROCESSOR
  M_OPENEDITOR
  M_CLOSEEDITOR
  M_OPENPLAYER
  M_CLOSEPLAYER
  M_OPENPREFS
  M_CLOSEPREFS
  M_OPENINFO
  M_CLOSEINFO
  M_MOVE x y
  M_TOFRONT
  M_TOBACK
  M_OPENTMAKER
  M_CLOSETMAKER
  M_OPENIMOPTIONS
  M_CLOSEIMOPTIONS
  M_ADDICON file
  M_CLEANUP
  M_RESET
  M_LOAD
  M_SAVE
Tools:
  T_DELPICTURELIST
  T_GETNUMBER title [preset]
  T_GETSTRING title [preset]
  T_GETFILE title [preset]
  T_GETDRAWER titlee [preset]
  T_ANIMINFO name (0=o.k.)
  T_PICINFO name (0=o.k.)
  T_GETWIDTH
  T_GETHEIGHT
  T_GETDEPTH
  T_GETCOLORS
  T_GETFRAMES
  T_GETANIMDRAWER
  T_GETPICDRAWER
  T_GETMODDRAWER
  T_GETROOTDRAWER
  T_PEXTENSION extension
  T_REQSTATUS (ON|OFF)
 Prefs:
  PR_PLAYERSCREEN name
  PR_SCREENMODE id width height depth
  PR_SCREENDEPTH depth
  PR_LOADPREFS
  PR_SAVEPREFS
  PR_OPENPATHS
  PR_CLOSEPATHS
  PR_OPENMACROS
  PR_CLOSEMACROS
  PR_DCLICKTIME val
  PR_REQTIMEOUT val
  PR_CLICKTOFRONT (ON|OFF)
  PR_STATISTICS (ON|OFF)
  PR_EXPERTMODE (ON|OFF)
  PR_MOVE x y
 Paths:
  PT_ANIMATIONDRAWER name
  PT_PICTUREDRAWER name
  PT_SOUNDDRAWER name
  PT_ROOTDRAWER name
  PT_YAFAPLAYER name
  PT_ANIMPLAYER name
  PT_MPEGPLAYER name
  PT_VIEWER name
  PT_MOVE x y
 Info:
  I_FREEMEM
  I_MOVE x y
 Text:
  TXT_TEXT file
  TXT_TEXTNC file
  TXT_MOVE x y
  TXT_CLOSE
  TXT_WAIT
  TXT_CENTRE
 Player:
  P_FILE [name]
  P_BUFFERS num
  P_ABUFFER num
  P_DISPLAY (NORMAL|ZOOMED|DITHERED)
  P_CACHING (ON|OFF)
  P_OUTPUT (HARDWARE|WINDOW|BGWINDOW|SCREEN)
  P_24BIT (TRUE|DRGB|DRGB2|GRAY)
  P_SCREENMODE hexnum
  P_WAIT (ON|OFF)
  P_PLAY [from to]
  P_MOVE x y
  P_OPENANIMINFO
  P_CLOSEANIMINFO
  P_OPENTIMECODES
  P_CLOSETIMECODES
 AnimInfo:
  AI_MOVE x y
  AI_EXPORT name
  AI_IMPORT num
 Timecodes:
  TC_RANGE from to step
  TC_IMPORT name
  TC_EXPORT name
  TC_TIMERANGE num
  TC_MOVE x y
 Editor:
  E_AADD name
  E_AKILL
  E_AREPLACE name
  E_AINFO
  E_ASELECT name
  E_ASELECTNEXT
  E_ASELECTPREV
  E_AFROM from
  E_ATO to
  E_AUP
  E_ADOWN
  E_MADD name (MODULE|SAMPLE|EXECUTABLE)
  E_MKILL
  E_MREPLACE name
  E_MEDIT
  E_MSELECT name
  E_MSELECTNEXT
  E_MSELECTPREV
  E_MUP
  E_MDOWN
  E_OPENPROFILE
  E_CLOSEPROFILE
  E_OPENFILMCONTROL
  E_CLOSEFILMCONTROL
  E_PLAYALL
  E_PLAYSEL
  E_SAVEALL
  E_FILENAME [name]
  E_CLEAR
  E_EXPORT
  E_LOAD
  E_SAVE
  E_INSERT file
  E_APPEND file
  E_MOVE x y
 EditorAnimInfo:
  EAI_DISPLAY (NORMAL|ZOOMED|DITHERED)
  EAI_CACHING (ON|OFF)
  EAI_BUFFERS num
  EAI_ABUFFER num
  EAI_SPEED num
  EAI_MOVE x y
  EAI_CLOSE
 ModuleOptions:
  MO_TEST
  MO_STOP
  MO_CLOSE
  MO_MOVE x y
 SampleOptions:
  SO_TEST
  SO_STOP
  SO_CHANNEL (LEFT0|RIGHT0|LEFT1|RIGHT1)
  SO_REPEAT num
  SO_VOLUME num
  SO_CLOSE
  SO_MOVE x y
 CommandOptions:
  CO_TEST
  CO_CLOSE
  CO_MOVE x y
 Processor:
  PC_ADD type [options]
    SCALE in out width height [(PIXELS|PERCENT) (IGNORE|TAKEWIDTH|TAKEHEIGHT)]
    CROP in out left top width height
    AUTOCROP in out
    ALPHA in alpha out left top
    COMPOSE left top mix back=(STREAM|TEMPx) fore=(STREAM|TEMPx) dest=(STREAM|TEMPx) (NONE|COLOR|INRANGE|OUTRANGE) [red1 green1 blue1 [red2 green2 blue2]]
    BALANCING in out red green blue bright contrast gamma saturation
    DISPLACE in out radius probability seed
    ROTATE in out centreX centreY radius amount zoom
    NEGATIVE in out
    COLORTOGRAY in out (AVERAGE|LUMINANCE|CUSTOM) [red] [green] [blue]
    SHIFTLINES in out (HORIZONTAL|VERTICAL) shift [(NORMAL|POSITIVE|NEGTIVE) amount probability seed]
    SAVETEMP buffer
    LOADTEMP buffer
    KILLTEMP buffer
    LOADIMAGE out sequence repeat shift
    CREATEIMAGE out width height [red0 green0 blue0 ... red3 green3 blue3]
    PIXELIZE in out width height (ON|OFF) [(XY|X|Y) size red green blue dLeft dRight dTop dBottom]
    CONVOLVE in out mix shift (file|matrix)
    TWIRL in out (IN|OUT) centreX centreY radius amount power zoom
    BUMP in heightMap out left top amount lightX lightY lightZ intensity
    TEXT out red green blue (NORMAL|OUTLINE|EMBOSS) (LEFT|RIGHT|CENTERED) hSkip font fontSize italic bold underline color textFile [strength [lightX lightY lightZ intensity]]
    ANTIQUE in out
    HALVE in out
    FLIP in out (X|Y|XY)
    MOTIONBLUR in out deltaX deltaY
    ROTATEBLUR in out centreX centreY amount radius
    BLACKHOLE in out centreX centreY amount radius
    MAGNET in out centreX centreY amount damping
    WAVE in out centreX centreY (X|Y) frames frame zoom damping (ON|OFF) amplitude wavelength phase shift
    AREXX in out port tempfile script
    COMMENT [string]
    PLASMA out width height dimension seed
    EMBOSS in out direction
    REPLACECOMP in1 in2 out (RED|GREEN|BLUE)
    OILTRANSFER in out rect
    MEDIANFILTER in out rect
    ADD in1 in2 out (ADD|SUBTRACT)
    RASTER in out
    SWAPRGB in out (RBG|GRB|GBR|BRG|BGR)
    NOISE in out intensity probability seed
    POSTERISE in out bits
    ROLL in out deltaX deltaY (ON|OFF)
    CARTESIAN2POLAR in out r0 phi0
    THRESHOLD in out level
    SHEAR in out originX originY amount (X|Y) zoom damping (ON|OFF)
    LWOB out file width height renderSettings
    DLA out width height iterations seed red green blue
    NEON in out (TRIVIAL|HKC) red green blue radius intensity tolerance
    SETBACKGROUND red greed blue
    GSIMPORT out file resolution xGeom yGeom
    EDGEDETECT in out contrast
    LINEART in out
    RIP in out
    COLORREGION in out centreX centreY (INCLUDE|EXCLUDE) tolerance
    RECTANGLE in out left top width height thickness red green blue
    CIRCLE in out centreX centreY radius thickness red green blue
    WIND in out (LEFT|RIGHT) intensity probability seed
    BGRADIENT in out mode (RED|GREEN|BLUE|CONTRAST|BRIGHTNESS|GAMMA|SATURATTION) (PARALLEL|RADIAL) x1 y1 value1 x2 y2 value2
    KILLTEMP3D buffer
    PERSPECTIVE in out renderSettings
    CUBE in out (ON|OFF) size (ON|OFF) alpha4 alpha5 alpha2 alpha6 alpha1 renderSettings
    WRAP in out (ON|OFF) (RADIUS|AMOUNT) radius amount (X|Y|XY) renderSettings
    WATER in out (ON|OFF) frames frame (X|Y|XY) originX originY times rings amplitude wavelength (ON|OFF) damping doXY=(ON|OFF) renderSettings
    WAVE3D in out (ON|OFF) frames frame (X|Y|XY|RADIAL) originX originY originZ amplitude wavelength phase (ON|OFF) damping renderSettings
    MAGNET3D in out (ON|OFF) strength srcX srcY srcZ destX destY destZ renderSettings
    SPHERE in out (ON|OFF) radius renderSettings
    TRANSFORM3D in out (ON|OFF) scaleX scaleY scaleZ transX transY transZ (XY|YZ|XZ|NONE) alpha beta originX originY originZ renderSettings
    BUMP3D in out (ON|OFF) map amount (ON|OFF) width height (IGNORE|TAKEWIDTH|TAKEHEIGHT) originX originY (ON|OFF) renderSettings
    JOIN3D in1 in2 out (ON|OFF) renderSettings
    TWIST in out (ON|OFF) (X|Y|Z) amount dist originX originY originZ renderSettings
    TWIRL3D in out (ON|OFF) (X|Y|Z) originX originY originZ amount radius power renderSettings
    COLORCUBE in out (ON|OFF) mix (COLOR|ALPHA) (CURRENT|ACTUAL) red1 green1 blue1 ... red8 green8 blue8
    SETCOLOR in out (ON|OFF) red green blue mix renderSettings
    TRIANGULATE in out (ON|OFF) renderSettings
    ZPLOT out expr xmin xmax xcount ymin ymax ycount red green blue (ON|OFF) gRed gGreen gBlue width height renderSettings
    PARPLOT out x y z umin umax ucount vmin vmax vcount red green blue (ON|OFF) gRed gGreen gBlue width height renderSettings
    DATAPLOT out file xQuant yQuant xScale yScale zScale red green blue (ON|OFF) gRed gGreen gBlue renderSettings
    MORPH in1 in2 out frame frames renderSettings
    GENLOCK3D in out (ON|OFF) (SINGLE|INRANGE|OUTRANGE) red green blue renderSettings
    AXIS3D in out (ON|OFF) xMin xMax xTicks yMin yMax yTicks zMin zMax zTicks red green blue thickness tickSize phong=(ON|OFF) doLabels=(ON|OFF) (FRONTBOTTOM|FRONTTOP|BACKBOTTOM|BACKTOP) (RIGHTBOTTOM|RIGHTTOP|LEFTBOTTOM|LEFTTOP) (FRONTRIGHT|FRONTLEFT|BACKRIGHT|BACKLEFT) fontSize xLabel yLabel zLabel lRed lGreen lBlue renderSettings
    renderSettings=camX camY camZ (XY|YZ|XZ|NONE) alpha beta
                   centreX centreY zoom (NORMAL|PHONG|OFF)
                   lightX0 lightY0 lightZ0 lightX1 lightY1 lightZ1
                   lightX2 lightY2 lightZ2 lightX3 lightY3 lightZ3
                   lightRed0 lightGreen0 lightBlue0 lightRed1 lightGreen1 lightBlue1
                   lightRed2 lightGreen2 lightBlue2 lightRed3 lightGreen3 lightBlue3
                   ambient diffuse phong phongSize phongAngle (NORMAL|DOUBLE|NDOUBLE) quant3D
  PC_KILL
  PC_CLEAR
  PC_SELECT type [which]
  PC_UP
  PC_DOWN
  PC_FROM num
  PC_TO num
  PC_STEP num
  PC_OPENEDIT
  PC_MOVEEDIT x y
  PC_CLOSEEDIT
  PC_MODE (COLOR|HAM6|HAM8)
  PC_DITHER (NONE|FS)
  PC_SMOOTHING (OFF|LOW|MEDIUM|HIGH)
  PC_DEPTH num
  PC_CSKIP num
  PC_FILENAME [name]
  PC_LOAD
  PC_SAVE
  PC_OPENPCSINGLEPICTURE
  PC_CLOSEPCSINGLEPICTURE
  PC_OPENVARIABLES
  PC_CLOSEVARIABLES
  PC_OPENPALETTE
  PC_CLOSEPALETTE
  PC_OPENSTORYBOARD
  PC_CLOSESTORYBOARD
  PC_MOVE
 Variables:
  V_ADD name
  V_SELECT name
  V_KILL
  V_RENAME
  V_SELECT name
  V_ENVELOPE
  V_FILENAME
  V_SAVE
  V_LOAD
  V_CLEAR
  V_MOVE
 Envelope:
  EV_XRANGE xmin xmax
  EV_YRANGE ymin ymax
  EV_VIEWALL
  EV_SCROLLUP
  EV_SCROLLDOWN
  EV_SCROLLLEFT
  EV_SCROLLRIGHT
  EV_SELECT num
  EV_SELECTNEXT
  EV_SELECTPREV
  EV_KILL
  EV_ADD xval yval
  EV_MOVE xval yval
  EV_DRAG xval yval steps
  EV_LOAD name
  EV_SAVE name
  EV_INTERPOLATION (SPLINE|BEZIER|LINEAR)
  EV_USE
  EV_CANCEL
  EV_OPENADVANCED
  EV_MOVE
 SinglePicture:
  PCS_INPUT name
  PCS_OUTPUT name
  PCS_TEST [time]
  PCS_SAVE
  PCS_SAVERENDERED
  PCS_APPLYDIMENSIONS
  PCS_FRAME num
  PCS_MOVE
  PCS_SCREENMODE id
  PCS_PREVIEWWIDTH val
  PCS_PREVIEWDEPTH val
  PCS_PREVIEW (ENABLED|DISABLED)
  PCS_ISHOW
  PCS_OSHOW
  PCS_IINFO
  PCS_OINFO
  PCS_CLOSEINFO
 EnvelopeAdvanced:
  EVA_RANGE from to step
  EVA_SCALE
  EVA_SHIFT
  EVA_LOADCURVE name
  EVA_SAVECURVE name
  EVA_LOADTIMECODES
  EVA_SAVETIMECODES
  EVA_XVAL val
  EVA_YVAL val
  EVA_CLOSE
  EVA_MOVE
 Converter:
  C_INPUTTYPE (ANIMATION|YAFAANIM|BLACKFRAMES|SEQUENCE)
  C_INPUTEXPORT
  C_INPUTFILENAME name
  C_OUTPUTTYPE (PICTURES|YAFAANIM|IFFANIM|NONE)
  C_OUTPUTEXPORT
  C_OUTPUTFILENAME name
  C_ANNOTATION (ON|OFF)
  C_ANNOFILENAME [name]
  C_ANNOSTRING [string]
  C_LOADSESSION
  C_SAVESESSION
  C_CONVERT
  C_CONVERTPICS first last
  C_OPENINPUTOPTIONS
  C_OPENOUTPUTOPTIONS
  C_CLOSEINPUTOPTIONS
  C_CLOSEOUTPUTOPTIONS
  C_PREVIEW (NONE|WINDOW|SCREEN)
  C_PROCESSOR (ENABLED|DISABLED)
  C_MOVE
 YAFAOptions:
  YO_IMAGEDATA (RAW|CHUNKY)
  YO_DELTA (NONE|BYTE|WORD|LONG|BYTEBR|WORDBR|LONGBR)
  YO_COMPRESSION (NONE|XPK)
  YO_COMPRESSOR name
  YO_MODE mode
  YO_COLORMAP (UNLOCKED|LOCKED)
  YO_SPEED num
  YO_FORCETIMECODES (ON|OFF)
  YO_OPENANALYSIS
  YO_MOVE
  YO_APPLY name
 Analysis:
  A_FRAMES num
  A_TEST
  A_USE
  A_CANCEL
  A_MOVE
 ANIMOptions:
  AO_TYPE (ANIM5|ANIM7S|ANIM7L)
  AO_COLORMAP (UNLOCKED|LOCKED)
  AO_SCREENMODE mode
  AO_MOVE
 PictureOptions:
  PO_BASENAME name
  PO_SCREENMODE mode
  PO_SHIFT num
  PO_MOVE
  PO_TYPE (RENDERED|TRUECOLOR)
 CreateFrames:
  CF_WIDTH num
  CF_HEIGHT num
  CF_FRAMES num
 Sequence:
  SQ_REPEAT num
  SQ_FRAMES num
  SQ_SHIFT num
  SQ_SEQUENCE file
 PictureList:
  PL_INSERT names
  PL_APPEND names
  PL_INSERTDIR name
  PL_APPENDDIR name
  PL_DUPLICATE times
  PL_SORT
  PL_CHECK
  PL_RANGE from to step
  PL_REMOVERANGE
  PL_TIMERANGE num
  PL_SHOW
  PL_SELECT name [which]
  PL_SELECTNEXT
  PL_SELECTPREV
  PL_OPENPICTUREINFO
  PL_CLOSEPICTUREINFO
  PL_MOVE
 Custom-Windows:
  CW_CLOSE name
  CW_OPEN name
  CW_MOVE name x y
  CW_ADD name width height
  CW_KILL name
  CW_ADDGADGET window (STRING|BUTTON|SWITCH) left top width name [action]
  CW_GETGADGET window name
  CW_SETGADGET window name value
  CW_WAITGADGET window name
  CW_ADDTEXT window left top pen text
  CW_ADDLINE window x1 y1 x2 y2 pen
  CW_ADDRECT window left top width height pen (NORMAL|FILLED|BBOX|BBOX2)
  CW_DRAWTEXT window left top pen text
  CW_DRAWLINE window x1 y1 x2 y2 pen
  CW_DRAWRECT window left top width height pen (NORMAL|FILLED|BBOX|BBOX2)
  CW_SAVE name
  CW_LOAD name
  CW_WAIT name
  CW_ISOPEN name
 Palette:
  PP_FILENAME
  PP_LOAD
  PP_SAVE
  PP_COLOR color red green blue
  PP_STATE (ENABLED|DISABLED)
  PP_MOVE x y
 FilmStrip:
  FC_PLAY file loops rows cols [left top]
  FC_FILE file
  FC_FILMFILE file
  FC_RANGE from to step
  FC_WIDTH width
  FC_SIZE rows cols
  FC_COLOR (ORIGINAL|GRAY)
  FC_UPDATE
  FC_CLEANUP
  FC_LOAD
  FC_SAVE
  FC_CONVERT
  FC_APPEND
  FC_SCROLL val (negative->scroll left)
 CRange:
  CR_FROM num
  CR_TO num
  CR_STEP num
  CR_STATE (ENABLED|DISABLED)
 IMOptions:
  IM_FILE file
  IM_TRASHCAN (KILLICON|DELETE)
 Icon-Saver:
  IC_Image1 file
  IC_Image2 [file]
  IC_ICON file
  IC_WIDTH width
  IC_DEPTH depth
  IC_COLOR (COLOR|GRAY)
  IC_CONVERT
 TMaker:
  TM_INPUT1 file
  TM_INPUT2 file
  TM_OUTPUT file
  TM_TEMP drawer
  TM_FRAMES frames
  TM_PREVIEW (NONE|WINDOW|SCREEN)
  TM_SHOWEXAMPLE (ON|OFF)
  TM_TYPE type subtype
  TM_CREATETEMPFILES
  TM_KILLTEMPFILES
  TM_PLAY
  TM_CONVERT
  TM_CREATEEXAMPLES
 StoryBoard:
  ST_WIDTH num
  ST_FRAME num
  ST_COLORS (ORIGINAL|GRAY)
  ST_UPDATE
  ST_SCROLLLEFT
  ST_SCROLLRIGHT
  ST_SCROLLUP
  ST_SCROLLDOWN
  ST_CLOSE
@endnode
@node PowerPlugs!
@{b}PowerPlugs! - it's not a dream @{ub}
@{u}Einf
hrung@{uu}                              @{" Beispiel 1 " system "visage wf:PowerPlugs!_01.jpg"}
PowerPlugs! sind eine erweiterte Funktion von Wildfire`s 3D-Operatoren.
Dadurch kann man Effekte im 3-dimensionalen Raum
berlagern.
Zum Beispiel kann man, nachdem man ein Bild auf einen W
rfel gemappt
hat, noch eine Radial-Welle
ber den W
rfel rechnen lassen.
Seit Version 3.14 kann man auch Phong-GeshadeteLightwave3D-Objekte
mit den Bildern verbinden. Nat
rlich lassen sich auch diese
Objekte mit Wildfire`s anderen 3D-Operatoren kombinieren.
Somit kann man innerhalb von ein paar Sekunden z.B. eine 3D-getwirlte
Kuh berechnen.
Das sind nat
rlich Eigenschaften, die man in den meisten
3D-Programmen vermi
Mittels PowerPlugs! kann man sogenannte "3D-Temp-Puffer" verwenden:
TEMP3D1, ... TEMP3D4.
@{u}Benutzung@{uu}                               @{" Beispiel 2 " system "visage wf:PowerPlugs!_02.jpg"} @{ub}
Die Benutzung ist recht einfach. Wenn man einen 3D-Temp-Puffer anstatt
eines normalen Puffers als Ausgabe angibt, wird die Transformation
an einem virtuellen Objekt und nicht an dem Bild ausgef
Das hei
t, da
 alle End-Transformationen wie z.B. das Rotieren,
Skalieren oder das Hinzuf
gen von Lichtquellen in diesem Fall
nicht berechnet werden. 3D-Temp-Puffer k
nnen nat
rlich als
Ein-und Ausgabe angegeben werden.
Besipiel: Sie m
chten zwei einfache Wellen kombinieren.
          F
gen Sie einen Wave3D-Effekt zu Ihrem Script hinzu,
          setzen sie den Ausgabe-Puffer auf TEMP3D1 und den
          originX-Wert auf 60.
          F
gen Sie einen zweiten Wave3D-Effekt hinzu,
          bestimmen Sie als Eingabepuffer TEMP3D1 und als
          originX-Wert 260.
          Was passiert nun? Das Bild wird vom ersten Befehl eingelesen
          und deformiert, nicht aber rotiert, gescalet oder gerendert.
          Das Resultat wird vom zweiten Wave3D-Effekt eingelesen
          deformiert und danacj rotiert und gerendert.
@{u}Operatoren@{uu}                               @{" Beispiel 3 " system "visage wf:PowerPlugs!_03.jpg"} @{ub}
Die folgenden Operatoren unterst
tzen das PowerPlugs!-Konzept und k
deshalb uneingeschr
nkt kombiniert werden:
   @{" Axis3D          " link opAxis3D         } Hinzuf
gen von Achsen in sehr hoher Qualit
t  @{" Beispiel " system "visage wf:doc/pictures/Axis3D.pic"}
   @{" Bump3D          " link opBump3D         } Echtes Bump-mapping                           @{" Beispiel " system "visage wf:doc/pictures/Bump3D.pic"}
   @{" ColorCube       " link opColorCube      } 3D Farbraum und Alpha-Kanal                   @{" Beispiel " system "visage wf:doc/pictures/ColorCube.pic"}
   @{" Cube            " link opCube           } Ein Bild wird auf einen W
rfel gelegt         @{" Beispiel " system "visage wf:doc/pictures/Cube.pic"}
   @{" DataPlot        " link opDataPlot       } Zeichnen von 3Dimensionalen Datens
tzen       @{" Beispiel " system "visage wf:doc/pictures/DataPlot.pic"}
   @{" Genlock3D       " link opGenlock3D      } Dreidimensionales Genlock                     @{" Beispiel " system "visage wf:doc/pictures/Genlock3D.pic"}
   @{" Join3D          " link opJoin3D         } Verkn
pfung zweier 3D-Temp-Puffer             @{" Beispiel " system "visage wf:doc/pictures/Join3D.pic"}
   @{" KillTemp3D      " link opKillTemp3D     } L
schen eines 3D-Temp-Puffers
   @{" LWOB            " link opLWOB           } Laden und berechnen eines Lightwave-Objekts   @{" Beispiel " system "visage wf:doc/pictures/LWOB.pic"}
   @{" Magnet3D        " link opMagnet3D       } Greifen und bewegen von Bildteilen            @{" Beispiel " system "visage wf:doc/pictures/Magnet3D.pic"}
   @{" Morph           " link opMorph          } Interpolation zwischen zwei Objekten          @{" Beispiel " system "visage wf:doc/pictures/Morph.pic"}
   @{" ParPlot         " link opParPlot        } Zeichnen 3-dim. parametrischer Funktionen     @{" Beispiel " system "visage wf:doc/pictures/ParPlot.pic"}
   @{" Perspective     " link opPerspective    } Hinzuf
gen von Perspective zu einem Bild      @{" Beispiel " system "visage wf:doc/pictures/Perspective.pic"}
   @{" SetColor        " link opSetColor       } Ver
nderung der Objektfarben                  @{" Beispiel " system "visage wf:doc/pictures/SetColor.pic"}
   @{" Sphere          " link opSphere         } Ein Bild wird auf eine Kugel gelegt           @{" Beispiel " system "visage wf:doc/pictures/Sphere.pic"}
   @{" Transform3D     " link opTransform3D    } Berechnung von 3D-Transformationen            @{" Beispiel " system "visage wf:doc/pictures/Transform3D.pic"}
   @{" Triangulate     " link opTriangulate    } Umwandlung von Bildern in Phong-Objekte       @{" Beispiel " system "visage wf:doc/pictures/Triangulate.pic"}
   @{" Twirl3D         " link opTwirl3D        } Hinzuf
gen eines Twirls l
ngs jeder Achse     @{" Beispiel " system "visage wf:doc/pictures/Twirl3D.pic"}
   @{" Twist           " link opTwist          } Deformation eines Bildes mittels Rotation     @{" Beispiel " system "visage wf:doc/pictures/Twist.pic"}
   @{" Water           " link opWater          } Hinzuf
gen einer unharmonischen Wasserwelle   @{" Beispiel " system "visage wf:doc/pictures/Water.pic"}
   @{" Wave3D          " link opWave3D         } Hinzuf
gen einer harmonischen Welle           @{" Beispiel " system "visage wf:doc/pictures/Wave3D.pic"}
   @{" Wrap            " link opWrap           } Das Bild wird auf eine Kugel/Zylinder gelegt  @{" Beispiel " system "visage wf:doc/pictures/Wrap.pic"}
   @{" ZPlot           " link opZPlot          } Zeichnen von dreidimensionalen Funktionen     @{" Beispiel " system "visage wf:doc/pictures/ZPlot.pic"}
Denken Sie daran, da
 alle Parameter ganz einfach animiert werden k
und eine beliebige Anzahl dieser Operatoren kombiniert werden kann!
Alle Skripts, die benutzt wurden, um diese Bilder zu erzeugen,
befinden sich in der "wf:doc/PlugIns"-directory!
@{" Ich bin beeindruckt ! " system "visage wf:Motivation2.jpg"}
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Tutorials
@remark */
@remark /*************************************************************/
@node Tutorials
###############################################################################
#                                                                             #
#                          Macro-Demos                                        #
#                                                                             #
###############################################################################
Diese kurzen Makros zeigen einige Funktionen von Wildfire. Sie k
auch jederzeit direkt aus dem Program heraus gestartet werden. Dr
Sie dazu einfach die Funktionstaste `F10` und w
hlen Sie dann das
entsprechende `*DEMO.rexx` File aus.
Wenn Sie auf einen der folgenden Buttons dr
cken, wird das jeweilige
Makro sofort gestartet. Wildfire mu
 dabei laufen! Sie sollten nach
dem Starten des Makros auf den Wildfire-Bildschirm wechseln, da eine
Ausgabe dort auf Sie `wartet`.
                  @{" ConverterDemo " system "rx wf:Macros/converterDEMO.rexx"}
                  @{" VariablesDemo " system "rx wf:Macros/variablesDEMO.rexx"}
                  @{" ProcessorDemo " system "rx wf:Macros/processorDEMO.rexx"}
                  @{" EditorDemo " system "rx wf:Macros/editorDEMO.rexx"}
                  @{" PlayerDemo " system "rx wf:Macros/playerDEMO.rexx"}
###############################################################################
#                                                                             #
#                         Kurzes-Tutorial                                     #
#                                                                             #
###############################################################################
                  @{" 1. Tutorial 0                          " LINK Tutorial-0}
###############################################################################
#                                                                             #
#                       Sequencer-Tutorial  1                                 #
#                                                                             #
###############################################################################
                  @{" 1. Einleitung                          " LINK Tut1-Intro}
                  @{" 2. Hardware-Anforderungen              " LINK Tut1-Req}
                  @{" 3. Tutorial                            " LINK Tut1}
 Ein langer Workshop befindet sich in den folgenden Ausgaben
 des Amiga Magazins:   9/1997, 10/1997 und 11/1997
 Bitte ziehen Sie in Betracht, diesen Worshop auch durchzuarbeiten!
 Die Beispielscripts sind auf der Amiga Magazin-CD 9-10/1997
 enthalten.
@ENDNODE
@NODE Tutorial-0 "Beispiel 1"
@{b} Kleine Beispiele
-----------------------------------------------------------------@{ub}
 (i) Eine Animation wird in negativen Farben angezeigt und eine kleine
     Version der Anim wird in den richtigen Farben dar
ber abgespielt
     Schema:
      *STREAM --> negativ speichern in TEMP1
      *STREAM --> halve   speichern in STREAM
      *Compose TEMP1 als Hintergrund und STREAM als Vordergund
       speichern in STREAM
     ARexx-Program:
      pc_add negative stream temp1
      pc_add scale stream stream width/2 height/2
      pc_add compose width/3 height/3 100 temp1 stream stream none
     Hinweis:
    *Die ARexx-Schreibweise hilft Ihnen beimerlernen des
         ARexx-Portes von Wildfire und erm
glicht es weiterhin,
         die Beispiele als Makros zu verwenden.
    *Nat
rlich sollten Sie die Beispiele erst innerhalb des
         Programmes ausprobieren. Starten Sie Wildfire, klicken
         Sie auf das PROCESSOR-GADGET und dr
cken Sie auf den
         ADD BUTTON. Doppelklicken Sie auf NEGATIVE und
         dann doppelklicken Sie auf den NEGATIVE Eintrag im
         Prozessor-Skript. Nun k
nnen Sie STREAM als INPUT
         w
hlen und TEMP1 als OUTPUT.

hnlich gehen Sie bei den anderen beiden Funktionen vor!
    *width und height sind die H
he und die Breite der Animation
         oder der Einzelbilder. Mittels des ARexx-Kommandos
         "T_ANIMINFO" oder "T_PICINFO" k
nnen Sie diese Details
         erhalten.
 (ii) Eine Animation wird auf einem Farbigen Hintergrund abgespielt.
      Weiterhin erh
lt die Animation einen wei
en Rand mit Schatten.
      Schema:
    *Erzeugung eines farbigen Hintergrundes mit der Breite
         width+80 und der H
he height+80 in "TEMP1"
    *Erzeugung des wei
en Bildes mit der Breite width+20 und
         der H
he height+20 in "TEMP2" Der Rand ist 10 Pixel breit
         (20/2)
    *Erzeugung eines schwarzen Bildes mit der Breite width+20
         und der H
he height+20 in "TEMP3"
         Auch dieser Rahmen ist 10 Pixel
    *Plazierung des schwarzen Bildes auf dem farbigen Hintergrund
         mit einem Offset von 40x40 Pixeln
    *Plazierung des wei
en Bildes auf dem farbigen Hintergrund,
         auf dem sich schon das schwarze Bild befindet, mit einem
         Offset von 30x30
    *all diese Berechnungen m
ssen nur einmalig gemacht werden,
         das Resultat wird im Puffer "TEMP1" gespeichert und NICHT
         mehr ver
ndert. Somit k
nnen wir Wildfire mitteilen, da
         diese Berechnungen nur einmalig durchgef
hrt werden m
ssen.
         Dazu legen wir den Bereich f
r diese Bilder fest, in dem
         wir als RANGE (G
ltigkeitsbereich) 0 0 1 angeben. Dies
         f
hrt dazu, da
 die Effekte auf jeden Fall nur 1 mal
         ausgef
hrt werden (auch wenn man nicht bei Bild 1 anf
    *jedes Bild der Animation wird nun mit dem Offset 40x40
         auf dem erzeugten Hintergrund mit schwarzem und wei
em Rahmen
         dargestellt.
      ARexx-Programm:
       /* create background and save to TEMP1  */
       pc_add createimage temp1 width+80 height+80 255 0 0  255 255 0  0 255 0  0 0 255
       pc_add createimage temp2 width+20 height+20 255 255 255  255 255 255  255 255 255  255 255 255
       pc_add createimage temp3 width+20 height+20 0 0 0  0 0 0  0 0 0  0 0 0
       pc_add compose 40 40 100 temp1 temp3 temp1 none
       pc_add compose 30 30 100 temp1 temp2 temp1 none
       /* only do this operations at frame 1 */
       pc_select createimage 1
       pc_from 0
       pc_to 0
       pc_select createimage 2
       pc_from 0
       pc_to 0
       pc_select createimage 3
       pc_from 0
       pc_to 0
       pc_select compose 1
       pc_from 0
       pc_to 0
       pc_select compose 2
       pc_from 0
       pc_to 0
       /* compose STREAM with TEMP1 for every animation-picture */
       pc_add compose 40 40 100 temp1 stream stream none
@ENDNODE
@NODE Tut1-Intro "1. Einleitung"
 Willkommen zum Sequencer-Tutorial !
 Dieser Workshop soll Sie mit den phantastischen M
glichen des
 Processors vertraut machen. Sie werden staunen, was man aus zwei
 einfachen Animationen machen kann.
 Da das einzigartige BUILD-FROM-BLOCKS-Konzept ausgenutzt wird, k
 sie schnell eigene Ver
nderungen in das Projekt einflie
 lassen.
 Informieren Sie sich zuerst
ber die @{" Hardware-Anforderungen " LINK Tut1-Req}!
@ENDNODE
@NODE Tut1-Req "2. Hardware-Anforderungen"
 Diese Tutorial ist f
r Benutzer mit mindestens folgender
 Rechnerkonfiguration gedacht:
  CPU: MC68020/MC68030
  RAM: 4 MB freier Fast, 2 MB Chip
  HD: 120 MB
  ca. 10 MB freier Platz auf der Festplatte werden ben
tigt!
 Wir empfehlen:
  CPU: MC68040/MC68060
  RAM: 8 MB Fast, 2 MB Chip
  HD: 1 GB
  ca. 25 MB freier Platz auf der Festplatte werden ben
tigt!
 Dies sind nat
rlich NUR Vorschl
ge, nat
rlich k
nnen Sie ihre pers
nlichen
 Einstellungen bez
glich des erzeugten Animations-Formats vornehmen und
 das Tutorial auf einem langsamen Rechner mit gr
erer Festplatte
 nutzen.
 Kommen wir nun zum @{" Tutorial " LINK Tut1}.
@ENDNODE
@NODE Tut1 "3. Tutorial"
                  @{" 0. Story                    " LINK Tut1-Story}
                  @{"  1. Vorbetrachtungen        " LINK Tut1-Teil0}
                  @{"  2. Teil 1                  " LINK Tut1-Teil1}
                  @{"  3. Teil 2                  " LINK Tut1-Teil2}
                  @{"  4. Teil 3                  " LINK Tut1-Teil3}
                  @{"  5. Teil 4                  " LINK Tut1-Teil4}
                  @{"  6. Teil 5                  " LINK Tut1-Teil5}
                  @{"  7. Teil 6                  " LINK Tut1-Teil6}
                  @{"  8. Teil 7                  " LINK Tut1-Teil7}
                  @{"  9. Teil 8                  " LINK Tut1-Teil8}
                  @{" 10. Teil 9                  " LINK Tut1-Teil9}
                  @{" 11. Script                  " LINK Tut1-Script}
@ENDNODE
@NODE Tut1-Story "Story"
 Auf die Ausgangs-Animationen "CHA" und "CHB", die als 24bit-Bilder
 vorliegen, sollen neben Ein-,
ber- und Ausblendungen einige Effekte
 angewandt werden.
 Story:
  -"CHA" kommt mit einem Wipe-Effekt in das Bild
  -"CHA" wird abgespielt
  -"CHA" wird um 360 gedreht
  -auf "CHA" wird ein Twirl-Effekt angewandt
  -"CHB" kommt in verkleinerter Form in das Bild "geflogen"
  -"CHB" wird gr
  -"CHA" wird ausgeblendet und `zerbr
selt`
  -"CHB" wird gespielt
  -"CHB" wird ausgeblendet
 Alle Session- und Process-Dateien befinden sich im jeweiligen Verzeichnis,
 zum Erzeugen der Animation, z.B. "chab_wipe.yafa", gibt es zwei
glichkeiten:
1. Benutzen der grafischen Benutzeroberfl
    *Converter: laden der Session-Datei "chab_wipe.session"
    *Converter: Bet
tigen des "Convert"-Gadgets (oder <Enter> dr
cken)
     (die n
tige Datei "chab_wipe.process" wird automatisch nachgeladen)
2. Da Sie aber lernen wollen, mit dem Processor umzugehen, empfehlen wir
   Ihnen die Animationen selber zu erzeugen! Wenn Sie dies erfolgreich
   durchgef
hrt haben, werden Sie den Umgang mit dem Programm als
   einfach empfinden und k
nnen leicht eigene Effekte ausprobieren.
 Dazu lesen Sie bitte erst die @{" Vorbetrachtungen " LINK Tut1-Teil0}!
@ENDNODE
@NODE Tut1-Teil0 "Vorbetrachtungen"
Vorbetrachtungen
Ihre Aktionen werden in geschweiften Klammern geschrieben.
Die beiden Animationen bestehen jeweils aus 60 Einzelbildern. Deshalb
beziehen sich alle zeitabh
ngigen Variablen auf die Endkoordinate 60.
Starten Sie zuerst Wildfire.
{wf <enter>}
ffnen Sie das Preferences Fenster.
{PREFERENCES}
Wechseln Sie in die Directory-Auswahl.
{PATHS}
Stellen Sie die ben
tigten Pfade ein.
{ANIMATIONS  wftut:halve_size/results/}
{PICTURES    wftut:halve_size/frames/}
{YAFA-PLAYER wf:YP}
Beenden Sie die Preferences.
{CLOSE Filenames/Drawers}
{SAVE Prefs}
{CLOSE Prefs}
Nun Sind alle Vorbereitungen getroffen. Gehen Sie nun weiter zu
@{" Teil 1 " LINK Tut1-Teil1}.
@ENDNODE
@NODE Tut1-Teil1 "Teil1"
cha_wipe.yafa
ffnen Sie den Converter.
{CONVERTER}
Falls Sie den einfachen Weg gehen wollen, laden Sie jetzt das erste Session
File.
{LOAD Session cha_wipe.session}
Alle Einstellungen werden automatisch getroffen und Sie k
nnen direkt mit
der Konvertierung beginnen.
{CONVERT}
Diese Art der Vorgehensweise funktioniert bei Allen 9 Teilabschnitten.
Laden Sie nur jeweils das richtige Session File.
Wir wollen nun aber die Funktionsweise des Programmes kennenlernen.
Deshalb laden wir NICHT die vorbereiteten Session-Files! Wir erzeugen
die Animationen selbst.
Schalten Sie den Input Type auf Single Pictures.
{INPUT TYPE Pictures}
Schalten Sie den Output Type auf YAFA Animation.
{OUTPUT TYPE YAFA Animation}
Stellen Sie die YAFA Optionen ein.
{RELATED OPTIONS}
{IMAGE-DATA RAW}
{COLORMAP UNLOCKED}
{FORCE TIMECODES OFF}
{SPEED 2} [3]
{POST-COMPRESSION XPK}
{Compressor FAST}
{DELTA-COMPRESSION ByteBR}
{Uncompressed Frames 1}
{UC-Mode Delta}
Beenden Sie YAFA-Options.
{CLOSE YAFA-Options}
Stellen Sie
{PREVIEW Screen}  und
{PROCESSOR Enabled}  ein.
ffnen Sie
{INPUT RELATED OPTIONS}
gen Sie die Directory mit den Bildern der Animation CHA hinzu.
{ADDDIR wftut:halve_size/frames/chA}
{CLOSE Related Options}
Bestimmen Sie den Namen der Animation.
{OUTPUT Browse}
{wftut:halve_size/results/cha_wipe.yafa}
ffnen Sie den
{PROCESSOR}
Im ersten Teil wollen wir die Animation CHA von links in den Bildschirm
fliegen lassen und Sie dabei sanft einblenden.
Dazu kreieren wir zuerst ein schwarzes Hintergrundbild:
{ADD CREATEIMAGE}
Danach editieren wir CreateImage.
{DOPPELKLICK CreateImage} (in der Liste) oder {EDIT}
Wir nehmen folgende Einstellungen vor:
{WIDTH 176}          ... Breite der Animation
{HEIGHT 144}         ... H
he der Animation
{OUTPUT Temp1}       ... Speicher des schwarzen Bildes
Weiterhin setzen wir alle 4 Farben auf die Werte 0,0,0. Die Farb-Gadgets
werden nur in Ihren richtigen Farben dargestellt, wenn Sie auf einem 256
Farb-Screen arbeiten. Da dies nicht der Fall ist, wundern Sie sich nicht
ber die falsch angezeigten Farben. Die RGB Werte m
ssen auf 0,0,0 f
r alle
4 Farben stehen.
************************************************************
Hinweis:
Um die meisten Koordinaten zu erhalten, bietet sich ein einfacher, aber
effektiver Weg an:
Z.B. CreateImage Effekt hinzuf
gen. Effekt selektieren. (wie oben
beschrieben)
{OPEN Single-Picture-Process}
{INPUT wftut:halve_size/frames/cha/pic.0001}
{APPLY DIMENSIONS}
Mittels Apply Dimensions werden die Daten des Bildes
bernommen. Dies sind
zum Beispiel beim CreateImage Effekt die Gr
e, bei Twirl und Rotate das
Zentrum etc.
Noch einfacher ist es, direkt im Effekt auf den Punkt {.} auf der Tastatur
zu dr
cken, dies ruft Apply Dimensions automatisch auf!
************************************************************
{CLOSE CreateImage-Options}
Nun kreieren wir Variablen.
{VARIABLES}
{ADD left}
{ADD mix}
{DOPPELKLICK left}
Wir sehen das Envelope-Fenster.
Nun f
gen wir zwei Punkte hinzu:
{ADD PNT  Klick in das Raster}
{ADD PNT  Klick in das Raster}
Um die genaue Position des ersten Punktes zu setzen, w
hlen wir Ihn an
{KLICK auf den 1. punkt}
{X = 0}                  (in das jeweilige Gadget eingeben!)
{Y = -160.00}
Nun w
hlen wir den zweiten Punkt an
{KLICK auf den 2. punkt}
{X = 5}
{Y = 0}
Nun w
hlen wir den dritten Punkt an
{KLICK auf den 3. punkt}
{X = 60}
{Y = 0}
Als Interpolation verwenden wir bezier.
{INTERPOLATION bezier}
Im weiteren Verlauf wird die Variablengenerierung stark abgek
rzt. Das obere
Beispiel lautet dann:
Variable:      left
Punkte:         3
Nr. 1:          0, -160
Nr. 2:          5,    0
Nr. 3:         60,    0
Interpolation: bezier
Kommen wir zur zweiten Variable.
Zweite Variable:
Variable:      mix
Punkte:         3
Nr. 1:          0,    0
Nr. 2:         20,  100
Nr. 3:         60,  100
Interpolation: bezier
{CLOSE Envelope}
{CLOSE Variables}
Nun f
gen wir einen Compose Effekt hinzu.
{ADD COMPOSE}
{EDIT compose}
{BACKGROUND Temp1}   ... Generiertes Bild in Temp1
{FOREGROUND Stream}  ... Animation im Stream
{DESTINATION Stream} ... Ziel -> Animation
{ALPHA none}         ... Alpha Kanal
{GENLOCK none}
{LEFT left}  ...
ber den Knopf VAR bei Left wird die Variable left
                 eingestellt. Die Variable left l
uft innerhalb der
                 60 Frame langen Animation von -160 bis 0.
                 Sie bestimmt die Position der vorderen Animation.
{TOP 0}          Die vordere Animation bleibt die ganze Zeit auf derselben
                 H
{MIX mix}        W
hrend der 60 Frames wird mix von 0 auf 100 erh
                 wodurch nach 60 Frames nur noch die vordere Animation
                 zu sehen ist.
{CENTREX off}        ... Zentrierung aus
{CENTREY off}        ... Zentrierung aus
{MODE Color}
{DITHERING Floyd}
{DEPTH 5}
Nun sind wir mit den Einstellungen fertig, und Sie k
nnen im Converter auf
Convert dr
cken.
{CONVERT}
Je nachdem wie schnell Ihr Rechner ist, k
nnen Sie sich einen Kaffee machen
oder bei der Kreation der Animation zusehen.
(Die 60 24-Bit-Bilder werden verschoben, gefadet, auf 5 Bit
heruntergerechnet und Floy-Steinberg gedithert...)
Ab dem @{" Teil 2 " LINK Tut1-Teil2} sind die Erl
uterungen nicht mehr so
hrlich.
@ENDNODE
@NODE Tut1-Teil2 "Teil2"
cha.yafa
Hier wird die Animation ohne jegliche Effekte generiert, es m
ssen also alle
Effekte aus der Liste entfernt werden.
{PROCESSOR CLEAR}
Die folgenden Einstellungen f
r die Animationen im Processor bleiben
erhalten. (Dies gilt f
r die gesamten Animationen dieses Tutorials!)
{MODE Color}
{DITHERING Floyd}
{DEPTH 5}
Die Input Single Pictures des Converters bleiben auch wie in Teil 1
beschrieben erhalten.
ndern den Output Namen in
{wftut:halve_size/results/cha.yafa}
Und schon k
nnen wir starten
{CONVERT}
@{" Teil 3 " LINK Tut1-Teil3}
@ENDNODE
@NODE Tut1-Teil3 "Teil3"
cha_rotate.yafa
Nun wird die CHA Animation rotiert.
Output-Name:
{wftut:halve_size/results/cha_rotate.yafa}
Variable:      rotate
Punkte:         2
Nr. 1:          0,    0   ... Startpunkt 0
Nr. 2:         60,  360   ... Einmal `rundherum`
Interpolation: linear
Wir f
gen im Processor einen Rotate Effekt hinzu:
{ADD ROTATE}
Wir nehmen folgende Einstellungen vor:
{INPUT Stream}       ... Eingabe Bilder
{OUTPUT Stream}      ... Ausgabe Animation
{CENTREx 88}         ... Mittelpunkt der Bilder, um den Mittelpunkt
                         angleichen zu k
nnen, gibt es eine einfache
                         M
glichkeit:
                         {SINGLE Picture}
                         {BROWSE Bild der Animation CHA}
                         {APPLY DIMENSIONS}
                         Und schon haben Sie die oben genannten
                         Einstellungen.
{CENTREY 72}
{RADIUS 120}         ... Radius, der rotiert wird.
{AMOUNT rotate}      ... Grad, um die rotiert werden soll.
{ZOOM 1}             ... Zoomfaktor
Nachdem dies eingegeben wurde, kann wieder convert gedr
ckt werden...
Weiter bei @{" Teil 4 " LINK Tut1-Teil4}...
@ENDNODE
@NODE Tut1-Teil4 "Teil4"
cha_twirl.yafa
Nun benutzen wir den Twirl Effekt. Wir `verdrehen` die Animation ein wenig.
{wftut:halve_size/results/cha_twirl.yafa}
Variable:      rotate
Punkte:         5
Nr. 1:          0,    0   ... Startpunkt 0
Nr. 2:         20,  100
Nr. 2:         30,  210
Nr. 2:         40,  100
Nr. 2:         60,    0   ... Endpunkt wieder 0
Interpolation: spline
Wir f
gen im Processor einen Twirl Effekt hinzu.
{ADD TWIRL}
Wir nehmen folgende Einstellungen vor
{INPUT Stream}       ... Eingabe Bilder
{OUTPUT Stream}      ... Ausgabe Animation
{FALLOFF out}        ... Richtung der Verst
rkung
{CENTREX 88}         ... Mittelpunkt der Bilder, um den Mittelpunkt
                         angleichen zu k
nnen, gibt es eine einfache
                         M
glichkeit:
                         {Single Picture}
                         {Browse Bild der Animation CHA}
                         {Apply Dimensions}
                         Und schon haben Sie die oben genannten
                         Einstellungen.
{CENTREY 72}
{RADIUS 150}         ... Radius, der `getwirlt` wird.
{AMOUNT rotate}      ... Gradzahl, um die `verwirbelt` wird.
{POWER 1}            ... Power bleibt gleich
{ZOOM 1}             ... Zoomfaktor
Der Twirl Effekt ist einer der sehr rechenintensiven Effekte. Starten Sie
den Convertierungsvorgang und machen Sie eine Pause, die haben Sie sich
verdient. Je nach der Geschwindigkeit des Rechners k
nnen Sie ruhig eine
Kanne Kaffee trinken :-)
Nach diesem interessanten Effekt kommen wir nun zum @{" Teil 5 " LINK Tut1-Teil5}.
@ENDNODE
@NODE Tut1-Teil5 "Teil5"
chab_wipe.yafa
Nun kommt zum ersten mal eine zweite Animation in das Bild. Sie wird bis
auf die H
lfte ihrer Gr
e herangezoomt und gleichzeitig von der linken
oberen Ecke in die Mitte des Bildes bewegt. Die animation CHA kann man
im Hintergrund weiterhin sehen.
{wftut:halve_size/results/chab_wipe.yafa}
Variable:      breite
Punkte:         2
Nr. 1:          0,    0        ... Anfangs-Breite 0
Nr. 2:         60,   88        ... End-Breite 88 (H
lfte von 176)
Interpolation: linear
Variable:      hoehe
Punkte:         2
Nr. 1:          0,    0        ... Anfangs-H
Nr. 2:         60,   72        ... End-H
he 72 (H
lfte von 144)
Interpolation: linear
Variable:      left
Punkte:         2
Nr. 1:          0,    0       ... Startpunkt ganz links
Nr. 2:         60,   44       ... Endpunkt, damit CHB in der Mitte steht
Interpolation: linear
Variable:      top
Punkte:         2
Nr. 1:          0,    0       ... Startpunkt ganz oben
Nr. 2:         60,   36       ... Endpunkt, damit CHB in der Mitte steht
Interpolation: linear
Nun f
gen wir im Processor folgende Effekte ein
{ADD LOADIMAGE}
{ADD SCALE}
{ADD COMPOSE}
Wir nehmen folgende Einstellungen vor
Loadimage:
{SEQUENCE wftut:halve_size/frames/chB/pic}
{OUTPUT Temp1}
{REPEAT AT 60}
Dieser Befehl l
dt jeweils das `pic` mit dem Index des jeweils zu
berechnenden Bildes der Animation (1 bis 60).
z.B. wird am Anfang chB/pic.0001 in den tempor
ren Buffer 1 geladen. Repeat
gibt an, bei welchem Frame der Index wieder auf 1 geschaltet werden soll.
Gibt man hier 1 an, wird immer nur das erste Bild benutzt.
Man hat 8 Tempor
re Buffer und den Stream zur Verf
gung. Damit kann man auf
einfachste Weise 9 (!!!) verschiedene Animationen miteinander kombinieren!
Scale:
{INPUT Temp1}   ... Eingabe Bild
{OUTPUT Temp1}  ... Ausgabe Bild
{WIDTH breite}  ... Breite
{HEIGHT hoehe}  ... H
{TYPE pixels}   ... Angaben in Pixel
{ASPECT ignore} ... Aspekt wird ignoriert
Das tempor
re Bild der CHB Animation wird auf die in den Variablen breite
und hoehe festgelegte Gr
e gescalet.
Compose:
{BACKGROUND Stream}  ... Hintergrund Bilder der Animation CHA
{FOREGROUND Temp1}   ... Vordergrund Bilder der Animation CHB
{DESTINATION Stream} ... Ausgabe in den Stream
{ALPHA none}         ... Alpha Kanal
{LEFT left}          ... Linke Position
{TOP top}            ... Position von oben
{MIX 100}            ... Mix = 100 hei
t man kann durch den Vordergrund
                         nicht durchsehen.
Die Anim CHB wird
ber die Animation CHA gelegt und von links oben bis in
die Mitte geschoben. Dabei kann man nicht durch CHB durchsehen. Der
Hintergrund der CHB Anim ist Schwarz, wir wollen die Farbe Schwarz
ausmarkieren, damit wir die Anim CHA dort sehen k
nnen, wo nicht das
gedrehte Zeichen der Animation CHB ist.
{CENTREX off}        ... Zentrierung aus
{CENTREY off}        ... Zentrierung aus
{GENLOCK SingleColor}  ... Nur eine Farbe ist durchsichtig
{ALLE RGB-WERTE  0}    ... Farbe 0 (Hintergrund der CHB Anim) ist
                           durchsichtig.
Nachdem alles eingestellt wurde, k
nnen wir CONVERT starten.
Kommen wir nun zu @{" Teil 6 " LINK Tut1-Teil6}.
@ENDNODE
@NODE Tut1-Teil6 "Teil6"
chab_scale.yafa
Dieser Animation Teil funktioniert fast genauso, wie chab_wipe.yafa.
Nur die Gr
e und die Position der Animation CHB ist anders.
{wftut:halve_size/results/chab_scale.yafa}
Variable:      breite
Punkte:         2
Nr. 1:          0,   88        ... Anfangs-Breite H
lfte der Anim
Nr. 2:         60,  176        ... End-Breite volle Gr
Interpolation: linear
Variable:      hoehe
Punkte:         2
Nr. 1:          0,   72        ... Anfangs-H
lfte der Anim
Nr. 2:         60,  144        ... End-H
he volle Gr
Interpolation: linear
Variable:      left
Punkte:         2
Nr. 1:          0,   44       ... Startpunkt -> CHB zentriert
Nr. 2:         60,    0       ... Endpunkt -> CHB ganz links, da volle
                                  Gr
Interpolation: linear
Variable:      top
Punkte:         2
Nr. 1:          0,   36       ... Startpunkt -> CHB zentriert
Nr. 2:         60,    0       ... Endpunkt -> CHB ganz oben, da volle Gr
Interpolation: linear
Nun f
gen wir im Processor folgende Effekte ein
{ADD LOADIMAGE}
{ADD SCALE}
{ADD COMPOSE}
Wir nehmen folgende Einstellungen vor
Loadimage:
{SEQUENCE wftut:halve_size/frames/chB/pic}
{OUTPUT Temp1}
{REPEAT AT 60}
Scale:
{INPUT Temp1}   ... Eingabe Bild
{OUTPUT Temp1}  ... Ausgabe Bild
{WIDTH breite}  ... Breite
{HEIGHT hoehe}  ... H
{TYPE pixels}   ... Angaben in Pixel
{ASPECT ignore} ... Aspekt wird ignoriert
Compose:
{BACKGROUND Stream}  ... Hintergrund Bilder der Animation CHA
{FOREGROUND Temp1}   ... Vordergrund Bilder der Animation CHB
{DESTINATION Stream} ... Ausgabe in den Stream
{LEFT left}          ... Linke Position
{TOP top}            ... Position von oben
{MIX 100}            ... Mix = 100 hei
t man kann durch den Vordergrund
                         nicht durchsehen.
{CENTREX off}        ... Zentrierung aus
{CENTREY off}        ... Zentrierung aus
{GENLOCK SingleColor}  ... Nur eine Farbe ist durchsichtig
{ALLE RGB-WERTE  0}    ... Farbe 0 (Hintergrund der CHB Anim) ist
                           durchsichtig.
Nachdem alles eingestellt wurde, k
nnen wir CONVERT starten.
Kommen wir nun zum @{" Teil 7 " LINK Tut1-Teil7}.
@ENDNODE
@NODE Tut1-Teil7 "Teil7"
chab_fade.yafa
Beide Animationen liegen nun in voller Gr
bereinander und man kann
durch den Hintergrund von CHB hindurchsehen. Nun wird CHA leicht
`zerbr
selt` und gleichzeitig ausgefadet.
{wftut:halve_size/results/chab_fade.yafa}
Variable:      probability
Punkte:         3
Nr. 1:          0,   0  ... Wahrscheinlichkeit, das ein Pixel versetzt wird.
Nr. 2:         59,   0
Nr. 3:         60, 100
Interpolation: bezier
Variable:      brightness
Punkte:         3
Nr. 1:          0,   0  ... Helligkeit der Animation CHA.
Nr. 2:         59, -10
Nr. 3:         60, -60
Interpolation: bezier
Variable:      radius
Punkte:         3
Nr. 1:          0,   0  ... Radius, in dem Punkte versetzt werden.
Nr. 2:         60,  20
Interpolation: linear
Nun f
gen wir im Processor folgende Effekte ein
{ADD LOADIMAGE}
{ADD DISPLACE}
{ADD BALANCING}
{ADD COMPOSE}
Wir nehmen folgende Einstellungen vor
Loadimage:
{SEQUENCE wftut:halve_size/frames/chB/pic}
{OUTPUT Temp1}
{REPEAT AT 60}
Displace:
{INPUT Stream}              ... Eingabe Bilder der Anim CHA
{OUTPUT Stream}             ... Ausgabe Stream
{RADIUS Radius}             ... Versetzungs-Radius
{PROBABILITY probability}   ... Versetzungs-Wahrscheinlichkeit
{SEED probability}          ... Startwert des Zufall-Generators
Balancing:
{INPUT Stream}        ... Eingabe Bild
{OUTPUT Stream}       ... Ausgabe Bild
{alles auf 0}
{BRIGHT brightness}  ... Helligkeit der Anim CHA
Compose:
{BACKGROUND Stream}  ... Hintergrund Bilder der Animation CHA
{FOREGROUND Temp1}   ... Vordergrund Bilder der Animation CHB
{DESTINATION Stream} ... Ausgabe in den Stream
{LEFT 0}             ... Linke Position
{TOP 0}              ... Position von oben
{MIX 100}            ... Mix = 100 hei
t man kann durch den Vordergrund
                         nicht durchsehen.
{CENTREX off}        ... Zentrierung aus
{CENTREY off}        ... Zentrierung aus
{GENLOCK SingleColor}  ... Nur eine Farbe ist durchsichtig
{ALLE RGB-WERTE  0}    ... Farbe 0 (Hintergrund der CHB Anim) ist
                           durchsichtig.
Nachdem alles eingestellt wurde, k
nnen wir CONVERT starten.
Kommen wir nun zum @{" Teil 8 " LINK Tut1-Teil8}.
@ENDNODE
@NODE Tut1-Teil8 "Teil8"
chb.yafa
Hier wird die Animation ohne jegliche Effekte generiert, es m
ssen also alle
Effekte aus der Liste entfernt werden.
{PROCESSOR CLEAR}
Die anderen Einstellungen bleiben erhalten.
{MODE Color}
{DITHERING Floyd}
{DEPTH 5}
Die Input Single Pictures des Converters m
ssen auf die neue Animation
ndert werden.
{REMOVE RANGE}
Nun m
ten alle Eintr
ge gel
scht sein. Ansonsten die richtige Range
angeben!
{ADDDIR wftut:halve_size/frames/chB}
ndern den Output Namen in
{wftut:halve_size/results/chb.yafa}
Und schon k
nnen wir starten
{CONVERT}
Kommen wir nun zum letzten Teil, @{" Teil 9 " LINK Tut1-Teil9}.
@ENDNODE
@NODE Tut1-Teil9 "Teil9"
chb_fade.yafa
Die Anim CHB wird jetzt nur noch ausgefadet.
{wftut:halve_size/results/chb_fade.yafa}
Variable:      brightness
Punkte:         3
Nr. 1:          0,   0  ... Helligkeit der Animation CHB.
Nr. 2:         59, -10
Nr. 3:         60, -60
Interpolation: bezier
Nun f
gen wir im Processor folgenden Effekt ein
{ADD BALANCING}
Wir nehmen folgende Einstellungen vor
Balancing:
{INPUT Stream}        ... Eingabe Bild
{OUTPUT Stream}       ... Ausgabe Bild
{alles auf 0}
{BRIGHT brightness}  ... Helligkeit der Anim CHA
Und dann CONVERT.
Herzlichen Gl
ckwunsch, Sie haben alle Animationen generiert! Nun k
nnen Sie
noch schnell ein @{" Script " LINK Tut1-Script} anlegen, um die Animationen
abzuspielen.
@ENDNODE
@NODE Tut1-Script "Script"
Wir starten den Editor.
{EDITOR}
Nun f
gen wir alle Animationen ein.
{ADD cha_wipe.yafa}
{ADD cha.yafa}
{ADD cha_rotate.yafa}
{ADD cha_twirl.yafa}
{ADD chab_wipe.yafa}
{ADD chab_scale.yafa}
{ADD chab_fade.yafa}
{ADD chb.yafa}
{ADD chb_fade.yafa}
Mittels INFO k
nnen wir f
r jede Animation Einstellungen vornehmen. Zum
Beispiel
{DISPLAY Zoomed} damit die Animation 2x2 gezoomed dargestellt wird oder
{BUFFERS 3} damit weniger Speicher ben
tigt wird.
Dies kann f
r alle Animationen eingestellt werden. Am besten spielen Sie
dann mit
{PLAY ALL} das Script ab. Dr
cken sie dann {AMIGA M} und sehen Sie sich die
Speicheranzeige an. Es sollte ruhig noch etwas FAST-MEM vorhanden sein!
Falls dies nicht der Fall ist, sollten Sie die Buffers der Animationen
heruntersetzen, damit die Animationen nicht im Chip-Mem bearbeitet
(gezoomed, entpackt etc.) werden m
ssen!
Nun k
nnen Sie dieses Project abspeichern
{PROJECT wftut:halve_size/Wildfire.prj}
{SAVE}
Mit Hilfe des Externen @{" YAFA " link yafa.guide/MAIN} Players k
nnen Sie nun jederzeit die
Animationen abspielen. Wildfire ben
tigen Sie dazu nicht. YP (der Spieler)
ist frei im Internet verf
gbar.
{YP -batch wftut:halve_size/Wildfire.prj}
Sie haben nun einige grundlegende Funtionen des Programms Wildfire
kennengelernt! Wir empfehlen Ihnen, die Anleitung zu lesen und alle anderen
glichkeiten des Programmes auszuprobieren.
Vielen Dank f
r die Benutzung dieses Tutorials!
@ENDNODE
@remark /*************************************************************/
@remark /*
@remark                            Demos
@remark */
@remark /*************************************************************/
@node Demos
                          W K  -  A r t w o r k s
                            in cooperation with
        INFECT A PART OF LIFE ELEMENTS - A RELIGION CAN'T DIE !
@{b}           Die folgenden Demos befinden sich auf der CD:
@{ub}
      @{" Dataworld 1 " link dw1}
      @{" Wild Summer " link ws1}
      @{" Dataworld 2 " link dw2}
@endnode
@node dw1
  Dataworld wurde auf der Party 1995 ind Fredericia/D
nemark herausgebracht.
  Es belegte den 2. Platz in der WILD COMPETITION, einem Wettbewerb, in dem
  keine Hardwarebeschr
nkungen vorhanden sind.
  Mit nur 70 MB (HD/CD) Platz erhalten Sie eine 10 Minuten Video Show, die
  auf voller Bildschirmgr
e abl
uft. Sie ben
tigen NUR einen standard A1200
  und 4 MB Fast Ram um Dataworld abzuspielen.
  Dataworld besteht aus
ber 30 @{" YAFA " link yafa.guide/MAIN} Animationen, die
  Mit dem gro
artigen Programm Wildfire erstellt wurden.
  Mit dem @{" YAFA " link yafa.guide/MAIN} Abspielprogramm k
nnen die Animationen selbst
  von einen 4xSpeed CD Rom ohne jegliche Unterbrechung abgespielt werden.
  Dataworld ist unter dem Copyright von:
  WK-Artworks                  (Animationen, Wildfire Konzept)
  Smack/Infect                 (@{" YAFA " link yafa.guide/MAIN} Konzept)
  DJ Mellow-Noise/Infect       (Music)
@endnode
@node ws1
  WiLD SuMMeR wurde auf der `Summer Party 96` in D
nemark herausgebracht.
  Es belegte den 2. Platz in der WILD COMPETITION, einem Wettbewerb, in dem
  keine Hardwarebeschr
nkungen vorhanden sind.
  Mit nur 30 MB (HD/CD) Platz erhalten Sie eine 4 Minuten Video Show, die
  auf voller Bildschirmgr
e abl
uft. Sie ben
tigen NUR einen standard A1200
  und 4 MB Fast Ram um WiLD SuMMeR abzuspielen.
  WilD SuMMeR besteht aus
ber 20 @{" YAFA " link yafa.guide/MAIN} Animationen, die
  Mit dem gro
artigen Programm Wildfire erstellt wurden.
  Mit dem @{" YAFA " link yafa.guide/MAIN} Abspielprogramm k
nnen die Animationen selbst
  von einen 4xSpeed CD Rom oder ZIP Laufwerk ohne jegliche Unterbrechung
  abgespielt werden.
  WiLD SuMMeR ist unter dem Copyright von:
  WK-Artworks                  (Animationen, Wildfire Konzept)
  Smack/Infect                 (@{" YAFA " link yafa.guide/MAIN} Konzept)
  DJ Mellow-Noise/Infect       (Music)
  Eksec/Infect                 (executive Producer)
@endnode
@node dw2
  DataWorld 2 wurde auf der `Party 96` in D
nemark herausgebracht.
  Mit 150 MB (HD/CD) Platz erhalten Sie eine 10 Minuten Video Show, die
  auf voller Bildschirmgr
e abl
uft. Sie ben
tigen NUR einen standard A1200
  und 4 MB Fast Ram um DataWorld 2 abzuspielen.
  Dataworld 2 besteht aus
ber 30 @{" YAFA " link yafa.guide/MAIN} Animationen, die
  Mit dem gro
artigen Programm Wildfire erstellt wurden.
  Mit dem @{" YAFA " link yafa.guide/MAIN} Abspielprogramm k
nnen die Animationen selbst
  von einen 4xSpeed CD Rom oder ZIP Laufwerk ohne jegliche Unterbrechung
  abgespielt werden.
  DataWorld 2 ist unter dem Copyright von:
  WK-Artworks                  (Animationen, Wildfire Konzept)
  Smack/Infect                 (@{" YAFA " link yafa.guide/MAIN} Konzept)
  DJ Mellow-Noise/Infect       (Music)
  Eksec/Infect                 (executive Producer)
@endnode
@remark /*************************************************************/
@remark /*
@remark                            Technical stuff
@remark */
@remark /*************************************************************/
@node Technical
@{b}Technische Informationen: @{ub}
Wildfire wurde mit StormC und MUIBuilder entwickelt  (NEIN!)
Wildfire ist ein sehr komplexes Programm, welches in ANSI-C geschrieben
wurde. Da die 10 MB Source zu "kompliziert" f
r die meisten AMIGA C
Compiler sind, haben wir uns f
r die Benutzung von GCC entschieden.
Einer dieser anderen "Compiler" war nicht einmal in der Lage, einige
Teile des ANSI-C Sources zu *
bersetzen* - das ist wirklich arm!
GCC compiliert alle 200 Module mit nur 6 warnigs.
Das GUI wurde komplett mit GadToolsBox erstellt, Wildfire 3.87
lt 151 Fenster mit 1400 Gadgets (einschlie
lich aller PlugIns)
Diese komplexit
t macht es unm
glich einen der sogenannten
"Intelligenten" GUI-Designer zu benutzen, aufgrund des gro
"Overheades", den sie erzeugen.
Das Hauptprogramm wurde immer in Richtung Geschwindigkeit entwickelt,
auf Speicherverbrauch wurde nicht viel R
cksicht genommen. (Sie k
Computer kaufen, Speicher kaufen, ... - aber keine Zeit!)
Alle 3D Operationen sind optimiert f
r die Benutzung einer FPU.
Auf Systemen ohne FPU kann es sein, da
 sie extrem langsam sind.
(Zum Beispiel ben
tigt eine Kombination (PowerPlugs!) eines Bump3D- und
Wrap-Effektes bei einem Bild der Gr
e 640x480 auf einen 060`er
Prozessor nur 30 Sekunden!)
Da die meisten "Floating-Point-Operationen" auf einem 060`er
Processor schneller sind, als Integer-Manipulationen, habe ich mich
entschieden, "nat
rlichen Code" anstatt kryptischer Integer-Berechnungen
zu verwenden.
Andererseits sind die 2D Operatoren auf allen Maschinen schnell, hier
wurden die Floating-Point-Operationen durch Inter Operationen ersetzt,
wie z.B.
"*luxa++=(WORD)((((dx2*ca+dy2*sa+VPREC2)>>SPREC)+cx+VPREC2)>>SPREC);".
Wie Sie sehen k
nnen, haben wir sehr viel Arbeit in dieses Projekt
gesteckt!
          @{b}BITTE BENUTZEN ODER VERBREITEN SIE KEINE RAUBKOPIEN !@{ub}
@endnode
@node RenderSettings
@{b}Render Settings@{ub}
In diesem Fenster k
nnen Sie die Render-Einstellungen f
r die
verschiedenen 3D-Operatoren, die das @{" PowerPlugs! " link PowerPlugs!}-onzept unterst
tzen,
einstellen.
Die meisten dieser Optionen werden ignoriert, wenn die Ausgabe des
Effektes ein Temp-3D-Puffer ist. Die einzige Ausnahme bildet der
"Quant 3D" Parameter, der die Qualit
t der gerenderten Bilder UND
der transformierten Objekte beeinflu
@{b}Parameter@{ub}
Name        M
gliche Werte/Puffer           Beschreibung
@{uu}
Zoom        -10.0...10.0                    Zoom-Faktor f
r das Bild
CentreX,    pixels                          Zentrum f
r das Zoomen und
CentreY     pixels                          Rotieren
CamX,       pixels                          Kamera-Position
CamY,       pixels
CamZ        pixels
Rotate      XY, YZ, XZ,                     Achsen Paar, um das rotiert
            NONE                            wird, ausschalten der Rotation
Alpha       degrees                         Erster Rotationswinkel
Beta        degrees                         Zweiter Rotationswinkel
Light       NORMAL, PHONG, OFF              Art des `Shadings`
Current     1...4                           Auswahl einer der 4 Lichtquellen
LightX,     pixels                          Position der ausgew
hlten
LightY,                                     Lichtquelle
LightZ
LightRed,   0...255                         Farbe dere ausgew
hlten
LightGreen,                                 Lichtquelle
LightBlue
Ambient     0.0...1.0                       Ambient Intensit
Diffuse     0.0...1.0                       Diffuse Intensit
Phong       0.0...1.0                       Phong Intensit
PhongSize   0.0...infinity                  Gr
e der "Phong-Spots"
PhongAngle  degrees                         Maximaler Gl
ttungswinkel f
                                            den Phong-Shader
Faces       NORMAL, DOUBLE                  Zeichnen der Fl
chen ein- oder
                                            zweiseitig
Quant3D     0.1...100.0                     @{" 3D-Quantizierungs-Wert " link pcQuant3D}
@{b}Functions@{ub}
Store       Kopieren der derzeitigen Einstellungen in den internen Puffer
Import      Importieren der Einstellungen aus dem internen Puffer
Diese Funktion ist sehr n
tzlich, wenn Sie eine "Perfekte" Scene erstellt
haben und danach aber noch mehrere 3D-Effekte hinzuf
gen wollen.
Speichern Sie einfach (Store) die Einstellungen Ihres alten Effektes
und Importieren Sie diese dann in den letzten Effekt des neuen
Skriptes.
@{b}Hinweise@{ub}
A) Camera Position
Um die Auswahl der besten Kamera-Position zu vereinfachen, werden
die angegebenen Parameter wie folgt interpretiert:
Das (camX,camY)-Paar bewirkt eine einfache Verschiebung des erzeugten
Objektes in der XY-Ebene, der camZ Wert bestimmt nur die perspetivische
Verzerrung. Die Objekt Gr
e kann mit dem Zoom-Parameter beeinflu
werden.
Dadurch kann man leicht Effekte erzeugen, die mit einem
nicht-transformierten Objet starten.
Die camZ Werte m
ssen immer im Bereich -100...-10000 sein.
Kleine Werte, wie z.B. -200 f
hren zu "seltsamen" Ansichten, gro
Werte wie z.B. -1000 f
hren zu einem fast parallelen Strahlenverlauf.
Dies h
ngt nat
rlich alles von der Objekt-Gr
e ab, aber der
Voreinstellungs-Wert -800 sollte im allgemeinen zu "normalen"
3D Ansichten f
hren.
B) Phong Shading
Phong Shading wird nur auf Dreiecke oder importierte Lightwave-Objekte
angewandt. Wenn man einfache Objekte ohne "scharfe" Kanten rendert,
empfiehlt sich ein PhongAngle gr
er als 180 Grad, da dadurch die
Berechnung beschleunigt wird.
C) Lightsources
Falls Sie sich nicht mit den verschiedenen Intensit
ten auskennen, ist
hier eine kleine Beschreibung:
 *ambient  : Ambient Intensit
t ist die Helligkeit des Objektes, wenn
             alle Lichtquellen aus sind
 *diffuse  : diffuse Intensit
t ist die Intensit
t des Lichtes, die
             verwendet wird, um die Objekt-Farbe zu beeinflussen
             (Die Kombination ambient=1.0 und diffuse=0.0 erzeugt
             somit "flache" Bilder)
 *phong    : Intensit
t dieser sch
nen hellen "Leuchtkegel"
 *phongSize: Gr
e der Phong-Spots, gro
e Werte (wie 10.0...100.0)
             erzeugen Fl
chen mit viel Glanz ("H
rte")
D) Coordinate System
Das folgende Koordinatensystem wird beim Transformieren und Rendern
der Bilder verwendet:
                                   -y^
                                     |________
                   y^                |        |
                    | /z       ===>  |        |
                    |/               |        |
                     ---> x           ----------> x
                    3D-Object          image
@endnode
@node ParameterSettings
@{b}Parameter Settings@{ub}
Das Parameter-Fenster wurde designt, um eine gleichartige Beeinflussung
aller Parameter zu erm
glichen.
Um Konfusione zu vermeiden, kann immer nur EIN Parameter ver
ndert werden.
Nach dem
ffnen des Parameter-Fensters haben Sie drei verschiedene
glichkeiten, um die Parameter zu beeinflussen:
 *Eingabe eines Ausdrucks oder eines Wertes in das "Value"-Gadget
 *Benutzung des Scrollbalkens um den Wert zu ver
ndern
 *Auswahl eines definierten Envelopes mittels des "Var"-Gadgets
Der Scrollbalken hilft vorallem, wenn Sie zum ertsen mal mit
Wildfire arbeiten. Seit Version 3.74 unterst
tzen die meisten
der Wildfire-Operatoren einen Echtzeit-Preview. In diesem Fall
erscheinen alle getroffenen
nderungen sofort im Linien-Preview
(noch w
hrend der Scrollbalken bewegt wird!)
@endnode
@node ColorSettings
@{b}Farb-Einstellungen (Color Settings)@{ub}
Das Farb-Fenster wurde geschaffen, um eine gleichartige und sehr
konfortable Methode anzubieten, die Farb-Parameter in den Wildfire
PlugIns einzustellen. F
r jede Farbkomponente existiert der
aus dem @{" Parameter-Settings " link ParameterSettings}-Fenster her bekannte Scrollbalken.
Weiterhin kann man die Farben auch aus der globalen Farb-Datenbank
hlen, die auch in diesem Fenster bedinet werden kann.
@endnode
@node TruecolorImages
@{b}Truecolor Images@{ub}
Seit Version 4.xx unterst
tzt Wildfire (Konverter und Prozessor) Truecolor-Bilder mit
einer Tiefe von 15 oder 24 Bit. Es gibt verschiedene "Tricks"
um solche Bilder auf AGA-Rechnern darzustellen.
Die Methode, die f
pr alle Processor, Player- und Converter-Darstellungen
angewandt werden soll, wird im @{" Player " link PlayerWindow}-Fenster eingestellt und
mit den Preferences abgespeichert.
(Diese Einstellung wird auf 15/24 Bit-Bildschirmen unter CyberGraphX
ignoriert)
Hinweis:
Um eine 15-oder 24 Bit Animation zu erzeugen, m
ssen Sie nur die Tiefe
im @{" Processor " link ProcessorWindow}-Fenster auf 15-oder 24 Bit einstellen und
die Processor-Benutzung im @{" Converter " link ConverterWindow}-Fenster anschalten
(auf "Enabled" stellen)
@endnode
@node Bonus
@{b}Bonus Programme auf der CD@{ub}
Die folgenden Bonus-Programms sind auf der CD enthalten:
    @{" Dust Registrierte Version " link Dust    }
    @{" Visage Bildanzeiger       " link Visage  }
    @{" Drag.Gadget und Patchgels " link DragGadget }
    @{" NewIcons V4.1             " link NewIcons   }
    @{" Animations Datatype       " link AnimationDT }
Bitte werfen Sie einen Blick in die Bonus-Directory auf der
CD! Dort befinden sich die kompletten archive.
Lesen Sie die jeweiligen Dokumentationen bez
glich der
Benutzung und Verbreitung der Programme.
Vielen Dank an dieser Stelle an diese autoren!
@endnode
@node Dust
@{b}Dust@{ub}
Als Bonus-Program befindet sich DUST mit auf dieser CD in der
registrierten Version!
 Dust ist eine Spezialeffekt-Software, die sich mit der Manipulation von
 3D-Objekten befa
t. Es ist somit eine Erg
nzung zu den g
ngigen Objekt-
 Editoren und bietet fast ausschlie
lich Features an, die diesen fehlen.
 Zielgruppe sind haupts
chlich semiprofessionelle Anwender, die
 elementare Programmierkenntnisse und mathematisches Verst
ndnis verf
erdem sollte sich der Benutzer in der Bedienung eines 3D-Modelers und
 eines 3D-Renderers gut auskennen. Optimal ist hier der Einsatz des
 Programmes "Imagine3.1" oder "LightWave3D". Seit Version 2.32 wird
 auch das Objektformat des deutschen Programms "MaxonCinema4D" unterst
 Diese herausragenden Features des Programmes sind:
  -lokale Metamorphose, die Metamorphosen in h
chster Qualit
   erlaubt
  -Smooth-Funktion f
r Objekte, die unglaubliche Ergebnisse liefert
  -direkte Unterst
tzung der Programme "Imagine" und "Lightwave"
  -Laden, Speichern und Anzeigen von Objekt-Sequenzen
  -einfache Metamorphose beliebiger Objekte (incl. der Farben der einzelnen Fl
chen),
  -Partikel-System: extrem einfach zu handhaben, erm
glicht auch bei der
                    Objekt-Modelierung unerreichte Effekte,
  -realistische Explosionen (Gravitation, Stokes'sche Reibung, Drehimpulse),
  -realistische Wasser-Wellen (dreidimensionale nicht-harmonische Wellen)
  -ein- bis dreidimensionale Wellen verschiedener Arten incl. Partikel-Wellen
  -Punkte, Fl
chenfarben, Partikelposition, -Drehwinkel und -Skalierungsfaktoren
nnen algorithmisch modifiziert werden, somit k
nnen Sie Dust auch als
   hochwertigen Funktionsplotter verwenden
  -jeder Programmierer kann mit Dust auf einfachste Weise die verschiedensten
   Partikel-Effekte verwirklichen, dabei werden keinerlei Kenntnisse irgendeiner
   Objekt-Struktur (oder gar des TDDD-Formats) vorausgesetzt
  -Jede Fl
che kann (wie in Imagine) eine eigene Farbe erhalten, diese werden
   bei der Umwandlung in Partikel-Objekte reproduziert
  -Verwaltung und Ver
nderung von Imagine3.0-Texturen und -Brushes
  -Sphere-Objects: Particle-Objekte aus mathematischen Kugeln
  -Erzeugung von Objekten von externen Programmen aus m
glich
  -benutzerdefinierte Variablen, mathematische Ausdr
cke anstatt
   einfacher Zahlen als Argumente, Schleifen
  -Einbindung in andere Programme durch ARexx-Port m
glich
  -sehr leistungsf
hige Preview-Funktion
  -Kommandozeilen-Vervollst
ndigung
  -Online-Help
 Andere Programme, wie z.B. Imagine, das von Dust direkt untert
tzt wird,
 bieten auch einige dieser Effekte an. Der Nachteil dabei besteht darin,
 diese Effekte erst w
hrend des Render-Prozesses berechnet werden;
 man kann die Objekte, auf die diese Effekte einwirken, also nicht
 nachbearbeiten, weil es sie gar nicht gibt - mit Dust k
nnen unendlich
 viele Spezialeffekte linearkombiniert werden.
@endnode
@node Visage
@{b}Visage@{ub}
Auch Visage befindet sich in der Bonus-Directory der CD, weil es als
Voreinstellung f
r den Bildanzeiger verwendet wird und eines der besten
Bild-Anzeige Programme auf dem Amiga ist.  Unser Dan gilt Magnus Holmgren.
Visage ist ein Bild-Anzeiger f
r AmigaOS Version 3.0 und h
geschrieben von Magnus Holmgren. Es kann IFF ILBM, JPEG, PNG und
Datatypes Bilder anzeigen.
Haupt-Eigenschaften:
        Unterst
tzt AA (AGA), ECS, RTG, CyberGraphX, PCHG, SHAM and CLUT. ;)
        Kann tiefe Bilder aller Formate auf ECS Amigas anzeigen, gerendert
        in HAM, ind "normalen" Farben der in Graustufen.
        Kann "gerenderte" Bilder skalieren, damit sie den Bildschirm
        ausf
        Starke Monitor-Unterst
tzung. ann eine BestModeID()-
hnliche
        Funktion benutzen um einen geeigneten Modus zu finden
        Jeder "native" Amiga Mode kann durch Text eingestellt werden,
        keine Zahlen werden ben
tigt, k
nnen aber verwendet werden!
        Die Auswahl kann nat
rlich auch
ber einen Requester getroffen
        werden.
        Einfache
bergabe der Bilder an jeden installierten Monitor.
        Keine "Hardcoded" Kommando-Optionen werden ben
        Verschiedene Slideshow-Optionen, inklusive einem Zufalls-Modes,
        erlauben Visage als externes Modul z.B. f
r Screenblanker zu
        erbeiten.
        Es ist frei!
Das komplette Visage-Archive (auch die Dokumentation) ist in der Bonus
Directory auf der CD. Die neuste Version ist im Aminet (gfx/show)
ltlich oder im World Wide Web, unter der Adresse:
http://www.lls.se/~cmh/
r mehr Informationen
ber Visage und die Verbreitung etc.
lesen Sie bitte die Dokumentation.
@endnode
@node AnimationDT
@{b}Animation Datatype@{ub}
Der animation.datatype und einige datatypes sind in der Bonus
Directory auf der CD. Alle Animaions-Datatypes die mit dem
animation.datatype zusammenarbeiten, werden beim EINlesen von
Animationen unterst
Short:    animation.datatype V41.2
Uploader: [e-mail] (Roland Mainz)
Author:   [e-mail] (Roland Mainz)
Type:     util/dtype
This is the first official public version of animation.datatype V41.
INTRODUCTION
    animation.datatype is the datatypes base class for all animation
    and movie subclasses. It is responsible for remapping, sound,
    scronisation and misc. other things
FEATURES
    - Supports now the full animation.datatype interface like defined
      in include31:datatypes/animationclass.h:
      - Supports palette-per-frame, e.g. each frame can have it's own
        palette.
      - Dynamic timing. A frame can have a variable duration until
        the next frame occurs.
    - Fully compatible to the original animation.datatype V40.7
    - Configurable througth a preferences file.
    - Includes a CPU blitter for planar screens. If enabled by the prefs
      file, animation.datatype uses a CPU blitter instead of the OS
      blitter.
    - CyberGFX compatible:
      - Now animation.datatype V41 can handle non-planar bitmaps, e.g.
        chunkypixel bitmaps, as input.
        (Currently they cannot be remapped, the bitmaps are displayed
        unchanged on the destination screen).
      - Supports HAM/EHB -> 24-bit remapping. (TEMPORARY DISABLED).
    - No skipping anymore. The aniation.datatype V41 introduces
      a new feature called "adaptive frame rate selection". Instead
      of skipping frames when they cannot be displayed in real-time,
      the FPS rate is now adapted to fit (e.g. the maximum available
      playback speed without skipping).
REQUIREMENTS
    - You need at least Kick/WB 3.0.
    - "realtime.library", >= V39              - for timing
    - "gadgets/tapedeck.gadget" (any version) - for the controls
       You need "sound.datatype" >= V40 for sound support.
USAGE
    Usage is very simply: If you  have loaded an animation, you can
    control the animation using the tapedeck gadget at the bottom:
    "<<" skips some frames back
    ">"  starts playing
    ">>" skips some frames forward.
    The slider part can be used to move manually to a specific
    postion in the animation/movie.
    Note that there is also a prefs-file where you can set various
    options. See "preferences" section for details.
INSTALLATION
    After unpacking this archive:
    Because this version does not include an Installer script, you have
    to do the installation manually through the shell:
      - Unpack this archive and copy the "animation.datatype" to
        SYS:Classes/DataTypes/:
        Copy CLONE FROM "animation.datatype" TO
        "SYS:Classes/DataTypes/animation.datatype"
AUTHOR
    If you want to blame me, report any bugs, or wants a new version
    send your letter to:
                    Roland Mainz
                    Hohenstaufenstra
                    52388 N
rvenich
                    GERMANY
    Phone: [phone]
    Fax:   [phone]
    EMAIL is also available (if you want to send me attachments
    larger than 1MB (up to 5MB, more with my permission):
    [e-mail]
    Up to December 1997 I'm reachable using this email address, too:
    [e-mail]
    | Please put your name and address in your mails !
    | German mailers should add their phone numbers.
    | See BUGS section above when submitting bug reports.
    Sorry, but I can only look once a week for mails.
    If you don't hear something from me within three weeks, please
    send your mail again (but watch about new releases) (problems with
    this email port are caused by reconfigurations, hackers, network
    problems etc.).
    The  entire  "animation.datatype"  package  may  be  noncommercially
    redistributed, provided  that  the package  is always  distributed
    in it's complete  form (including it's documentation). A small
    copy fee  for media costs is okay but any kind of commercial
    distribution is strictly forbidden without my permission !
    Comments and suggestions how to improve this program are
    generally appreciated!
Roland
@endnode
@node DragGadget
@{b}Drag Gadget@{ub}
Auch das Drag.gadget befindet sich in der Bonus-directory.
Die neuste Version des Drag.gadget finden Sie im Internet:
aminet/dev/gui/draggadget*.lha
Es wird in Wildfire f
r das Drag-n-drop benutzt.
Falls Sie eine alte CyberGraphX-Software benutzen, kann sich Wildfire
`aufh
ngen`, wenn Sie auf Ikons klicken. Dies liegt an einem Fehler
in der CyberGraphX-Software, wir empfehlen eine neuere Version zu
benutzen oder zumindest das `Patchgels` Program aus dem Drag.Gadget
archive zu starten! Dieses Programm behebt den Fehler.
drag.gadget release 1.0b2
-------------------------
Copyright
 1996/97 J
rg Kollmann
All rights reserved.
This is a new beta version of my drag&drop gadget BOOPSI class.
I have tested it (not very much) on an A3000 with kickstart v40.
Look at the two example programs (dragtest.c and droptest.c).
Note that this is a beta version of drag.gadget and its example
programs. They are not tested very much, so you use them at your own
risk!
Notes:
- The driver software of some graphics cards seems to introduce a bug
  with the GELS animation system, causing the system to crash if
  animated bobs are used. If this is the case for your system, it can be
  resolved with the patchgels program (see patchgels drawer).
You may use and distribute *this version (drag.gadget 40.21)* freely
with your application, if you send me bug reports. This includes
reporting system configurations running this class without problems.
[e-mail]
@endnode
@node NewIcons
Einige der Icons auf der Wildfire CD sind solche NewIcons.
Die Benutzung dieses -freien- Programmpaketes k
nnen wir nur
empfehlen!
Sie ben
tigen u.a. folgendes um NewIcons zu installieren:
-Version 43.3 des Amiga Installers
 (z.B. Aminet:  Installer_43_3.lha util/misc  104K  CD 16)
-ClassAct
 (z.B. ist eine Demoversion im Aminet:
  ClassAct2Demo.lha  dev/gui    589K  CD 20)
Short:    The Ultimate GUI Enhancement System, V4!
Author:   Eric Sauvageau <[e-mail]>, Phil Vedovatti <[e-mail]>
Uploader: [e-mail]
Type:     util/wb
Replaces: util/wb/NewIconsV4.lha
 NewIcons is a revolutionary system patch which enhances your Workbench
 and gives the user much more power and configurability over the
 appearance of the GUI (Graphical User Interface).  The NewIcons
 system works transparently, and provides for a standard icon system
 that will look the same on any system, no matter what the palette is
 set to.
 DefIcons complements the Newicons system.  It works by
 recognizing a file's type, and instantly displaying the appropriate
 icon image for files without icons attached to them.
 The system's features include:
 Allows up to 256 color icons on an AGA machine. (!)
 Icon colors are color correct on an AGA system, no matter what your
   palette is set to.  They automatically appear in perfect color.
 Default icons for dozens of file types automatically appear for
   files without icons (FAST!).  Recognizes file types in a very
   efficient manner.  If you click on a "fake" icon, your appropriate
   user-defined default tool will appear in the "Execute command" text
   field automatically!
 Make a brush, convert it to an icon.  It will appear on your workbench
   in the _exact_ proper colors you created it in, no matter what your
   palette is set to.  Imagine making gorgeous icons from your digitized
   pics, in _more_ than 32 colors!
 Icon images are compressed to maximize disk space.  They are
   uncompressed faster than you can say "NewIcons"!
 Also KS 2.04 compatible (16 color icon limitation).
 Fix that ugly Cross-DOS icon to look like a standard NewIcon.
 Unique icons for RAM-Disks and CD-ROM's that don't have icons.
 A complete set of beautiful, standardized Workbench icons, drawn by
   Phil Vedovatti.  Hundreds of icons are also available separately on
   Aminet, some with a totally different style.
 Comprehensive set of utilities to allow you to manipulate your
   NewIcons.
 Totaly FREE!  Why would anyone want to pay cash for icons?
 Dithering of icon images is selectable for users with fewer available
   Workbench colors.  This is turned off by default.
 Icons can be given a single tooltype, which will tell NewIcons to display
   a NewIcon image from elsewhere on the system.  This feature
   has some caveats, but introduces a huge number of neat possibilities
   for configuring your Workbench, and saves on disk space and chip RAM.
   Imagine having your Workbench icons appear randomly different on EACH
   reboot!
 The source for deficons.prefs has been included, so any enterprising
   programmer can add their own file identification types to the system!
 User configurable, GUI enhanced Preferences program to configure all
   attributes of the NewIcons system (dither, pen precision, etc.)
 The NewIcons patch is a commodity, which can be enabled and disabled
   on the fly, using Commodities Exchange.
 RTG (ReTargetable Graphics) mode, which allows graphics card users
   to store icon data in fast RAM instead of chip RAM.  This has the
   advantage of saving your valuable chip RAM for other uses, and speeds
   up rendering of icons on the Workbench.
 Border removal option!  Remember the Kickstart 1.3 days when there
   were no gray border boxes around the icons?  This new option removes
   those silly looking boxes once again, and is user configurable.
 The system library is available in different versions, to ensure the
   best speed possible on every system configuration.
 NEW IN V4: Dragged icons can also be optionally made transparent.
 NEW IN V4: The text shown under the icons can be optionally rendered
   with a 3D or an outlined look.
 NEW IN V4: New utilities to make updating whole
   drawers or partitions with a specified drawer image, and a popup
   menu utility that displays icon images in a menu format -- could even
   be used as a program dock launcher with the appropriate scripts.
 NEW IN V4:  New 32 color icon set.  NewIcons is now sufficiently faster
   to allow fast rendering of higher bitplane icons.
Changes since 4.0:
------------------
 LE/newicon.library was accidently requiring graphics.library V39
   instead of V37, so Kickstart 2.04 users were unable to run NI4 at all.
 Icon TextMode can't work under 2.04 because pen handling was only
   added in Kickstart 3.0.  So it's now disabled under 2.x. (NewIcons
   and NewIconsPrefs)
 Removed some debugging output that was forgotten in CreateDefaultIcon.
 CreateDefaultIcon wouldn't properly create a disk.info file (it was
   named '.info') if used from the CLI on a disk.  Also, it can now
   properly handle logical names, so 'CreateDefaultIcon t:' will
   properly create a Ram:T.info file.
 Fixed all the icons in Icons/Misc/Disks  and /Icons/Misc/Drawers.  The old
   icon structure was corrupt, causing CopyNewIcon to crash if run from the WB.
 Fixed the drawer type deficons in envarcsys...same problem...damn C= Iconpos
   Program!
 Changed misnamed envarcsys/def_Trash.info to def_trashcan.info
 Changed misnamed envarcsys/def_CDDA.info to def_CDDAdisk.info
 Changed misnamed envarcsys/def_CD0.info to def_CD0disk.info
 Deleted obsolete deficons (def_zoo.info, def_zoom.info, def_arc.info,
   def_lzh.info, def_lha.info, def_tar.info)
 Added deficons def_NETdisk.info, def_FTPdisk.info, def_RADdisk.info,
   def_mpeg.info and def_DTYP.info
 Fixed Preview.gif...it no longer has transparency set. Not included in the
   update file, but is in the full 4.1 archive.
 Included deficons.prefs source.
 Made a small change to the installer to hopefully identify 2.04 systems better for
   installation of the Low End version of the newicon.library.   (People, please
   upgrade...2.04 is ancient!)
 See the enclosed documentation for more information, and visit the
 official NewIcons Web Page at:
--------------------------------------------------------------------------
                 http://www.amiganet.org/NewIcons/
--------------------------------------------------------------------------
IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!
Please read the documentation carefully.  The icons in this archive
have special features and are very different from the usual icons
that you find in other icon packages.
Viewing them requires the NewIcons program to be running.
Patchopenwb must also be installed if you are using Workbench
3.0 or higher.
You NEED version 43.3 of the Amiga Installer to install this package
properly.  The install script won't run if you don't.  Gives you a
good excuse to upgrade to it anyway.  It's on Aminet in util/misc.
If you are running 2.0, you need to set up an appropriate palette.
One is included for your viewing pleasure.
New since version 3, NewIcons must be launched in the user startup with:
run <>NIL: c:newicons
Read the docs!
Failing to do so may result in much frustration.
IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!
@endnode